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Op 


10 minutes from now, you'll know how to run a computer. If you have a computer 
in front of you, it will already be printing answers to your problems. 

You don't have to be smart. I've taught second-graders how to do it. 

I'll be discussing the kind of computer found in most high-schools and 
universities—the kind that has BASIC wtth terminals. 

Warning: no two computers are exactly alike. Whatever I say might work 
slightly differently on yours, so ask the people hanging around your computer for 
help. They'll be glad to answer questions, because the way they got to know the 
answers was by asking. Another way to get unconfused is to read Commentary on the 
Seeret Guide to Computers, which has more examples, discusses differences between 
machines, touches on the finer points, and reveals extra tricks. Each section of 
this book has a corresponding section in the Commentary. 

In science fiction, computers blow up. In real life, they never do. No matter 
what buttons you press, no matter what commands you give, you won't hurt the 
computer. The computer is invincible! So go ahead and experiment. If it doesn't 
like what you say, it will gripe at you, but so what? 


TERMINAL 


To communicate with a computer, you type on a special electric typewriter, 
called a terminal. A wire runs from the terminal to the computer, so the computer 
finds out what you typed: 


Ca 


at 1 computer 


When the computer wants to reply, it sends the reply over the wire and makes the 
terminal print it. 

A traditional terminal uses paper, but the more exciting kind uses a television 
screen instead; whatever is typed appears on the screen. 

Computers are so big and powerful now, that a single computer can handle many 
terminals from many miles around. Instead of running a long wire from each terminal 
to the computer, it"s simpler to connect the terminal to a beeper (called a coupler) 
and connect the computer to another beeper; when the terminal and the computer want 
to communicate, they beep to each other over the telephone; 


data set 


{phone & coupler 
combined) 


terminal computer 


The terminal's keyboard looks like this: 
! PE EPS tee : ( ) = 
sg fd eS od ASE Poa s Z| 8s 19 - 
[ESCAPE ais 
RN 
ESCAPE] | la a \¢| ene FEED] [CARRIAGE RETU 
Be dle Ve es 
t Sh Side Z 
S 
esumenl [5] [xl [| [ol [o) Lx) Gal (E] (2) (2) Se 


SPACE 


When you type, the letters are automatically capitals. (Only the most expensive 
terminals have small letters.) 


One of the keys looks like this: 


N 


If you press it, you'll type an N. If you press it while holding down the SHIFT 
key, you'll type an up-arrow instead. Here's another weird key: 


. 
> 


If you press it, you'll type a semicolon. If you press it while holding down the 
SHIFT key, you'll type a plus sign instead. The general rule is: if a key has 
two symbols on it, and you want to type the top one, hold down the SHIFT key. 

It's funny to watch people try to press the SHIFT key and another key at the 
same time. It's impossible; you're going to wind up hitting one before the other. 
The trick is to hold down the SHIFT key first; and while you keep holding it down, 
give the other key a light tap. 

The top row of keys contains the numbers. Don't confuse 1 with I; the number 


1 is in the top row. Don't confuse zero with Oh; the number zero is in the to 
row, and usually has a slash through Tt, Igkebthis: 0. 
At the right side of the keyboard is the CARRIAGE RETURN. On some terminals, 


it is marked RETURN or CR or NEW LINE. Press the carriage return at the end of 
every line you type. It makes the computer react. 


GETTING STARTED: SIMPLE PROGRAMS 


The way to begin using your computer depends very much on who manufactured it. 
Here's the general idea, but ask the folks hanging around the terminal for help and 
details—if you try it alone, your chance of making an error is about 5024. 

Remember to press the carriage return at the end of every line you t 
1. Find a terminal no one else is using. 

2. Make sure the terminal is turned on and its knobs are adjusted properly. 
If there is a knob marked LOCAL-LINE, it should be turned to LINE. 

3. If you're using a coupler, turn it on, pick up the phone, dial the 
computer, wait for the computer to answer the phone (it will answer by making a 
igh-pitched hum), and put the phone receiver on the coupler, making sure the cord 
end of the receiver is in the correct hole of the coupler. 

4. You might have to type HELLO or LOG. 

5. The computer will ask you to type your user number. Type it. If it 
contains a zero, make sure you type zero and not Oh. If it contains a comma, don' 
put a blank space after the comma. ‘a 

6. The computer might ask you to type a secret password. Type it. When you 
are typing it, the letters will be invisible; so if your enemy is looking over 
our shoulder, he won't be able to read it. %. cal 

7. You might have to type BASIC or R BASIC. 

8. Invent a name for the problem you want the computer to solve. Pick 
any name that's short--no more than 6 characters. The name can be HARRY or MOMMY 
or WEIRDO or TICKLE. You can pick the name of your favorite girlfriend or 
boyfriend or activity. Type the word NEW, followed by the name, like this: 


e! 


Le. 


That works on most computers. On CDC computers, put a comma after NEW instead of 
a space. On Hewlett-Packard computers, type this instead: 
SCRATCH 

NAME-HARRY 

On Xerox computers, type CLEAR instead, and omit the name. 


The next step is to type your program. A program is a list of numbered 
commands. For example, if you want the computer to print the answer to 17.9-2, 
and -6+1, and also print I LOVE YOU, type this program: 

PePRiNTs 17; 9-2 

2 PRINT -6+1 

a2 PRINT?" L LOVE NYOU" 

4 END 

Every line of the program must be numbered. The message "I LOVE YOU" must be in 
quotation marks. Every line should say PRINT, except the last line, which should 
say END. (On CDC, PDP-11, and Xerox computers, the END line can be omitted.) 

When you've finished typing the program, make the computer obey it, b giving 
this command: 

RUN 
Altogether, you've typed this: 
IBPRINT* 17° 9=2 
JePRINTe = 64-1 
3° PRINT !'L /2OVE. YOU" 
4 END 
RUN 
The computer will reply by printing the name of the program, the time, the date, 
and the answers: 
ond 
a. 
I LOVE YOU 
Then the computer will brag about itself, by telling you how many seconds it spent 
figuring them out. 
If you type RUN again, the computer will do it again. 
it you type—— 
Peek NiS PLATE VOUS 
RUN 
—you'll change line 3 and make the computer run the new version of the program. 
The computer will print: 
15.9 
=) an 
I HATE YOU 

To eliminate that program and begin a new one, do step 8 again, then type 

the new program. 


Now you know how to run the computer. A person who writes a program is a 
programmer. Be a programmer: write your own program now! 

Vocabulary, spelling and punctuation are important. If you type line 1 like 
this-— 
GeCOMPUTE: 1/2 9=2 
Gresike this 
Pee RIM el (oe 
gre Lent tas -s 
ORIN Tal 59.2 
the computer won't understand; when you type RUN, the computer will gripe at you, 
and say: 
ILLEGAL INSTRUCTION IN LINE 1 
Retype line 1 correctly and then try RUN again. 

The computer usually ignores blank spaces. This is okay: 
1PR INT Te a es = 2 

If you_type a line incorrectly, one remedy 1s to retype it correctly underneath. 


Here's an dlternative:... 


A character is a letter, digit, space, or some other symbol that can be made 


with a single tap of your finger. To cancel the last two characters you typed, 


do this: 


IF YOUR COMPUTER USES THE DARTMOUTH SYSTEM IF YOUR COMPUTER USES THE PDP SYSTEM 
Type two back-arrows, by typing two Press the RUB OUT key twice. For 
shifted Oh's. For example, FANCY<< is the} |example, if you've typed FANCY and 
same as FAN, And FANCY<<GED is the same want to rub out the Y and the C, 

as FANGED. press the RUB OUT key twice; when you] 
do, you'll see FANCY/YC/, which means: 
FANCY minus the Y and C, which leaves 
FAN. If you want to turn the FAN 

into FANGED, type GED afterwards, so 
ou see this: FANCY/YC/GED. 
If you want to cancel the last three characters you typed, do the same thing three 


times instead of twice. 
If you see extra keys on the right side, marked BACKSPACE, CLEAR, HOME, or 


. u 
with additional arrows, don't use them! They are fakes: their effects aren t 
sent over the wire to the computer. 


When you're done using the computer and want to walk away, type: 
BYE 


That tells the computer to stop worrying about you. The computer will say you've 
logged out and reveal the total number of seconds it thought about you during the 
session. 

If you were using a phone, hang it up, and turn off the coupler. 

If your terminal uses paper, turn it off. But if it uses a screen instead, 
you should probably leave the power on; ask the people in your computer center. 


NUMERICAL CALCULATIONS 


The computer uses these symbols: 
EXPLANATION 
multiplication 


division 
exponent 
SQuare Root 
The symbols +, -, *, /, and + are called operations. The symbol SQR is called a 
funetiton; the parentheses around the 9 are necessary. 
For example, to find the square root of 64, type this: 


NEW JOE 
1 PRINT SQR(64) 
2 END 
RUN 
The computer will print 8. 
Do not put commas in large numbers. Four million should be written as 


4000000 instead of 4,000,000. 
If an answer is very large or very tiny, the computer prints it by using an 


E, which means Exponent. If the computer says the answer is 4.52931E8, it means 


the answer is .4.52931x10°%.. “ Imocher words, take 4.52931 and move the decimal 
POintite thesright 8 placess thesanswer tie approximately: 

45293100. 

The exact answer might be 

45293100.3 

or 


45293101.79 
or some similar number; the computer is giving you an approximation. 


If the computer says the answer to a problem is 9.26E-4, it means the answer 
is 9.26x10-+4. In other words, take 9.26 and move the decimal point to the left 4 
places; the answer is: 

.000926 
You can use the E notation when writing your program. You can say l1E6 
instead of 1000000. 

The highest number a PDP-10, PDP-11, or Dartmouth-type computer can think 
of is about 1.7x10°8; other computers go even higher. If you try to go higher 
than your computer can handle, it will say OVERFLOW and give the largest number it 
can think of. 

The tiniest decimal a PDP-10, PDP-11, or Dartmouth-type computer can think of 
is about 1.51029; other computers go even tinier. If you try to go tinier than 
your computer can handle, it will say UNDERFLOW and change the decimal to zero. 

You can use parentheses the same way as in algebra. For example, 5-(1+1) . 
means 5-2, which is 3. You can have parentheses inside parentheses: 


10-(5-(1+1)) means 10-3, which is 7. 
To solve a problem, the computer uses the three-step process taugh tan 


algebra and the "new math"; so if you never took algebra or new Mati, Or worgot 
them both, you'll find the computer's answers surprising. For example, suppose 
you ask the computer to figure out 70-342+8/2*3. The computer will not begin by 
subtracting 3 from 70. Instead, it will begin by squaring 3. Here's the 
three-step process: 

SCY On Denim en eo cls ae tiets oe eur ees 70-0120) 273) 


Step 1: ‘get rid of 4. Now the problem is...... 70- 9 +8/2%*3, 


Step 2: get rid of * and /. Now the problem Teei0= Logue 
NO 


it rid of + sandlc,. | The answer 16..... Tee 
In each step, it looks from left to right. For example, in step 2, it sees / and 
gets rid of it before it sees *. ; 


LINE NUMBERS 


Suppose you type this program: 
20 PRINT ''MARK"' 
LORERINE “BILLY 


32 PRINT "SUZY" 

50 PRINT "FREDDY" RA 
32 PRINT "JOAN" Ges 
70 

99 END 

80 PRINT "TOM" 

80 


In its mind, the computer rearranges the instru tions in ascending order, 
liven this: 
LORERINT BILL 
20 PRINT ''MARK" 
32 PRINT "JOAN" 
50 PRINT ''FREDDY" 
99 END 
Since you typed two versions of line 32, the computer assumes the second was a 
correction of the first, and ignores the first. Since line 70 said nothing, the 
computer ignores it. Since you typed two versions of line 80, the computer 
aseumes the second was a correction of the first; the second said nothing, so the 
computer assumes you wanted line 80 erased. 


If you think about that example, you'll notice two things: 
To revise a line. just retype it. 


To erase line 80, just type— 


ith nothing else on the line. * 
What's in the computer's mind is not necessarily what's on your terminal—~in 
the computer's mind, the lines are rearranged in ascending order, all your erasures 
and revisions have been performed, and some new errors might have cropped up 


because of a defective terminal. , Whenever you're confused, find out what version 
of your program is actually in the computer's mind, by typing LIST. The computer 


will print its version, which may surprise you. 

The word NEW erases your program from the computer's mind, to make way for a 
new one. But the word RUN does not erase the program; after the run, you can 
continue inserting, deleting, and revising lines. 

If your first line is numbered 1, and your second line is numbered 2, you 
can't squeeze a line between them, since decimals are not permitted. So number 
your. linessl0 20." 30 we inet eacmc we eee 


VARIABLES 


Any letter can be used as a variable. Here's an example: 
10 LET A=25 
20 PRINT A+2 
30 END 
When you type RUN, the computer will print 27. That's the only number it will 
Printer Leow Wonoteprint eo 
Most computers let you omit LET, so you can write this instead: 
10 A=25 
ZOU" BRINE At+2 
30 END 
One variable can define another: 


10 M=6 Wi 
20 P=M+1 VA 


30 PRINT M*P 


4 
40 END | My 
Since M-is 6,-and P°is)7, the computer will print 42. “i 


A variable can change: 
10 F=4 
20 F=9 
50 PRINT Ft? 
40 END 
Line 10 says F is 4. Line 20 changes F to 9, so line 30 prints 81. 


10 A=5 
20, A=3+A 
30 “PRINT Artz 
40 END 
Line 20 is pronounced, "The new A is 3 plus the old A." So the new A is 3+5, which 
is. 8. Line 30 prints 64: 
The left side of the equation must be one variable: 


ALLOWED NOT ALLOWED NOT ALLOWED 
Map +3 M=P=3 3=P-M 


: +t ; 4 
one variable two variables not a variable 


The variable on the left side of the equation is the only one that changes. 
For example, the instruction M=P+3 changes the Valuesor MM put not. Ps “The 
instruction A=B changes the value of A but not B: 
10 A=1 
20 B=9 
30 A=B 
40 PRINT A+B 
50 END 
Line 30 changes A, to make it equal to B; so A becomes 9. Since both A and B are 
now 9, line 40 prints 18. 
If you don't define a variable, the computer assumes itis zero: 
10 PRINT R 
20 END 
Since R hasn't been defined, line 10 prints zero. 
The computer does not look ahead: 
10 PRINT X 
20 X=5 
30 END 
When the computer encounters line 10, it does not look ahead to find out what X is. 
As of line 10, X is still undefined, so the computer prints zero. 
So far, that makes 26 variables you can use: ARE ROR, ppheoichioy un Lyarben ok that.san0t 
enough to make you happy, you can use a letter-followed-by-a-digit instead: 
10. A5=8t2 
20 PRINT A5 
30 END 
The computer will print 64. 
A string is any collection of characters, such as "T LOVE YOU" or ''76 TROMBONES" 
or "GO AWAY!!!!!" or 'XYPW EXR///746". Each string must be in quotation marks. 
A variable that stands for a string must end in a dollar sign: 
10 GS="DOWN" 
20 PRINT GS 
30 END 
Line 20=prints: 
DOWN 
In that program, the dollar sign is supposed to remind you of a fancy S, which 
stands for String. Line 10 is pronounced, "G String is DOWN." 
Some computers allow only 26 string variables: AGMeRSes Ose. o> ae. perer 
computers also allow a letter-followed-by-a-digit, such as A5S. 


CONTRASTS 


The computer's notation is similar to the one used in arithmetic and algebra, 


but here are some contrasts: 
TRADITIONAL NOTATION COMPUTER NOTATION EXPLANATION 


PE EN ae a Pare Md Puen yen PUEEEROS crise? Ain 


5*(N+M) AGterISK. 
NoM 


(A+B) /C 


Put the numerator in parentheses, 


(T2960) 16 if. it’ contains addition or subtractia 


5/(3+X) Put the denominator in parentheses, 
if it contains addition, subtraction, 


5*At3/(4*B) multiplication, or division. 


Xt+(N+2) 


Xt (3*N) Put the exponent in parentheses, 


54(2/3) if it contains an operation. 


9+1/2 Putea plus sign between the whole part 
_ and the fraction part. 


INPUT 


This program finds the square of 7: 
10 X=7 
20. PRINT *XtZ 
30 END 
When you type RUN, line 10 says X is 7, so line 20 prints 49. 

That program finds the square of just one number, 7. The next program is 
more powerful; it finds the square of any number: 
LOVINPUT *X 
20 WPRINTSXt2 
30 END 
When you type RUN, line 10 makes the computer print a question mark and wait for 
you_to type any number. The number you type will be X. For example, suppose you 
type 8 after the question mark, like this: 
nS 
When. you press the carriage.return after thegoy that 8 will be X. Line ZO "prince 
Hes square. which, 1s) 0s, 

Altogether, the run looks like this; I've underlined the part typed by you: 


RUN 
2? 8 
64 
The number you put it, 8, is called the tmput. The number the computer put 
out, 64, is called the output. Input and Output aré collectively called J/0. 


If you want to square 11 instead of 8, type 11 after the question mark 
instead of 8. If you want to square several numbers, type RUN several times, 
Pikes this: 

RUN 


You can program the computer to do geometry: 
10 PRINT "WHAT IS THE LENGTH OF YOUR RECTANGLE?" ‘ 


2) INPUT L 

30 PRINT "WHAT IS THE WIDTH?" 

40 INPUT W 

50 PRINT "THE AREA IS"L*W arning: some computers require a semicolo 
60 END in line 50, between "THE AREA IS" and L*W. 


Line 10 makes the computer print WHAT IS THE LENGTH OF YOUR RECTANGLE? Line 20 
makes the computer print a question mark and wait for you to type the number L. 
Suppose you type 3. Line 30 makes the computer print WHAT IS THE WIDTH? Line 40 
makes the computer print a question mark and wait for you to type the number W. 
Suppose you type 4. Line 50 prints ''THE AREA IS" then L*W, like this: 

THE AREA IS 12 

Altogether, the run looks like this: 


LENGTH OF YOUR RECTANGLE? 


WHAT IS THE WIDTH? 

24 

THE AREA IS 12 

Each time you type RUN, the computer will compute the area of another rectangle. 
Now that we've taught the computer how to find area, let's progress to volume: 

10 PRINT "WHAT ARE THE LENGTH, WIDTH, AND HEIGHT OF YOUR BOX?" 

20 INPUT L,W,H 

30 PRINT "THE VOLUME IS"L*w*H 


40 END 

Line 10 makes the computer print WHAT ARE THE LENGTH, WIDTH, AND HEIGHT OF YOUR BOX? 
Line 20 makes the computer print a question mark and wai for you to input three 
numbers, separated by commas. For example, suppose you type: 

20,0; 6 


Line 30 makes the computer print: 
THE VOLUME IS 600 
If a circle has radius R, then its circumference is 27R, and its area is TR@. 
This program computes them: 
10 PRINT 'WHAT IS THE RADIUS OF YOUR CIRCLE?" 
20 INPUT R 
30) P232.14159265 
40 PRINT "THE CIRCUMFERENCE IS"2*P*R 
50 PRINT "THE AREA IS"P*Rt2 
60 END 
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Some people complain the computer reduces them to numbers. That's not 
necessary; the computer can greet you personally: 
10 PRINT "WHAT IS YOUR NAME?" 


20 INPUT NS 
30 PRINT "HELLO "NS 
40 END 


Line 10 makes the computer print WHAT IS YOUR NAME? Line 20 makes the computer 
print a question mark and wait for you to type a string. If you type GEORGE, line 
30 makes the computer reply: 


HELLO GEORGE | me 
In line 30, the space after HELLO is important; if you omit it, the computer 


will print: 
HELLOGEORGE 
The space must be within the quotation marks; this is incorrect: 
80 PRINT MHELLOUGNS 
In that program, when the computer asks you for your name, you can usually 
type it without quotation marks, like this: 
WHAT IS YOUR NAME? 
2? GEORGE 
But if the string you input contains a comma, you must use quotation marks. For 
example, if your name is HAPPY, JOLLY SANTA CLAUS, which contains a comma, you must 
use quotation marks: 
WHAT IS YOUR NAME? 
Colbie Y . JOLLY SANTA CLAUS" ; 
If you omit the quotation marks, the computer will think your name is just HAPPY, 
and that JOLLY SANTA CLAUS is a different string. 


This program prints a letter, admitting you to the college of your choice: 
10 PRINT ''WHAT COLLEGE WOULD YOU LIKE TO BE ADMITTED TO?" 
20° INPUT cs 
30 PRINT ''CONGRATULATIONS!"' 
40 PRINT "YOU HAVE JUST BEEN ADMITTED TO "C$ 
50 PRINT "IT FITS YOUR PERSONALITY" 
60 PRINTS’ S°HOPEPYOU"GON TO?" CS 


FOMPRINTO" RESPECTFULLY YOURS" 
SOS PRINT ¥ THE DEAN OF ADMISSION" 
90 END 


Line 20 makes the computer print a question mark. If you'd like to be admitted tc 
Harvard, type HARVARD after the question mark; you'll be pleased: 


WHAT COLLEGE WOULD YOU LIKE TO BE ADMITTED TO? 
? HARVARD 

CONGRATULATIONS! 

YOU HAVE JUST BEEN ADMITTED TO HARVARD 


IT FITS YOUR PERSONALITY 

I HOPE YOU GO TO HARVARD 
RESPECTFULLY YOURS 
THE DEAN OF ADMISSIONS 


HAT COLLEGE WOULD YOU LIKE TO BE ADMITTED TO? 
7 HELL 
CONGRATULATIONS ! 


YOU HAVE JUST BEEN ADMITTED TO HELL 
IT FITS YOUR PERSONALITY 
I HOPE YOU GO TO HELL 

RESPECTFULLY YOURS 

THE DEAN OF ADMISSIONS 


oY 


Whatever you input must be a constant. In computer jargon, a constant means 


a quantity expressed simply, without operations (addition, subtraction, 
multiplication, division, or exponents), functions, or variables: 


CONSTANT NOT A CONSTANT 

(CAN BE INPUT) (CANNOT BE INPUT) 

8 7+1 (uses addition) 

66666667 pe he (uses division) 

9.5 9+1/2 (uses addition and division) 

3E8 . 3*10t8 (uses multiplication and exponents) 
-5 0-5 (uses subtraction) 

1.4142136 SQR(2) (uses a function) 

BORINK DT! Ds (uses a variable) 


For example, if you try to input 7+l instead of 8, the computer will either gripe 
or think you mean just 7. 
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GOING AND STOPPING 
10 PRINT ''GOOD" 
20 GO TO 50 
30 PRINT ''BAD" 
40 PRINT ''CHERRY" 
50 PRINT "APPLE" 
60 END 
Line 10 makes the computer print GOOD. Line 20 makes the computer skip to line 50. 
The only words the computer will print are GOOD and APPLE. 
The computer understands the word STOP: 
10 PRINT "BUBBLE GUM" 
20 STOP 
BO SPRINTS rOXe 
40 END 
The computer will print BUBBLE GUM and then stop, without printing FOX. 
This program is tllegal: 
10 PRINT 'BUBBLE GUM" 
20 END 
30 PRINT "FOX" 
40 END 
Line 20 is illegal. Only the Zast line can be END. When you type RUN, the computer 
will gripe. 
For an interesting experience, run this program: 
POMP RINT: “GAT"' 
ZUSERINT. “DOG 
30 GO TO 10 
40 END 
The computer prints CAT and DOG, then jumps back to line 10, prints CAT and DOG 
again, then jumps back again....The computer will print the words CAT and DOG again 
and again, like this: 
CAT 
DOG 
CAT 
DOG 
CAT 
DOG 
CAT 
DOG 
etc. 


The computer will try to do that forever. Here's how to stop the computer: 


IF YOUR COMPUTER USES THE DARTMOUTH SYSTEM IF YOUR COMPUTER USES THE PDP SYSTEM 
Type STOP. The computer will say READY. Hold down the CONTROL key, while you 
type C twice. Hopefully, the 

computer will say READY; if it prints 
a period instead, type REENTER. 
When you stop the computer that way, you are giving it an abortion; the computer 


aborts the run. After the computer says READY, you can give any command, such as 
LIST. 


Here's a picture of that program: 


PRINT ''DOG"' ; 


The computer follows the arrows, which make it go round and round inva Loop haine 
computer will try to go round and round the loop forever, so the loop is called 
infintte. 

In the picture, the arrows are called flowlines. The path made by the arrows, 
and followed by the computer, is called the program's flow of control. The 
picture is called a flowchart. 

Here's an improvement of a program you saw before: 

10 PRINT "WHAT ARE THE LENGTH, WIDTH, AND HEIGHT OF YOUR BOX 

20 INPUT L,W,H 

30 PRINT "THE VOLUME IS"L*W* 

35 3G0sTORLO 

40 END 

Lines 10-30 make the computer find the volume of your box. Line 35 makes the computer 
go back to the beginning, to find the volume of a second box. The computer will 

find the volume of box after box after box, until you give it an abortion, by 
inputting STOP (on the Dartmouth system) or two controlled C's (on the PDP system). 


This program tells the computer how to have a conversation....Try it! 
10 PRINT "ARE YOU MY FRIEND?" 
20 INPUT AS 


30 IF AS="YES'' THEN 100 

40 PRINT "GO JUMP IN A LAKE." 
DOLL 

LOO W PRINT HAPS SWELL. 

999 END 


When the user types RUN, the computer asks ARE YOU MY FRIEND? Line 20 makes the 
computer wait for the user to reply; the reply is called AS. If A$ is YES, then 


the computer jumps from line 30 to line 100, prints THAT'S SWELL, and ends. If 
AS_is not YES, the computer proceeds from line 30 to line 40, prints GO JUMP IN A 


LAKE, and stops. 
The whole conversation looks like this, if the user types YES: 
ARE YOU MY FRIEND? 
? YES 
THAT’S SWELL. 


But if the user types NO, here's what happens: 

ARE YOU MY FRIEND? 
2? NO 
GO JUMP IN A LAKE. 

In the course of the conversation, the computer has to make a decision: in 
line 30, it has to decide whether to go to line 100 or to line 40. The decision 
depends on the truth or falsity of this condition: AS="YES". So line 30 is called 
a dectston or a condtttonal. Here's the flowchart: 


PRINT “ARE YOU MY FRIEND?" 
{ INPUT AS 


y PRINT, THATS SWELL 


The flowchart has two branches: one branch says to print THAT'S SWELL and end; 
the other says to print GO JUMP IN A LAKE and stop. Since the branches are created 
by line 30, that line is called a branching tnstructton. 

Line 30 shows the computer can make decisions. Can the computer think? If 
making decisions is synonymous with thinking, the answer is yes. 

In that program, line 50 is important. Suppose you omit it, so the program 
looks like this: 

10 PRINT "ARE YOU MY FRIEND?" 

20 INPUT AS 

S00 nr AS="YES' 2 THEN’ 100 

40 PRINT "GO JUMP IN A LAKE.” 

100 PRINT)? THAT! SySWEh Lise: 

999 END 

If AS as: YES> then the computer jumps from line 30 to, line 100, prints, THAT'S SWELL, 
and ends. If A$ is not YES, the computer proceeds from line 30 to 40, and prints; 
GO JUMP IN A LAKE. 

THATS SWELL. 
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Here's a more intricate conversation: 
10 PRINT "ARE YOU MALE OR FEMALE?" 
20 INPUT AS 
30 IF AS=''MALE" THEN 1000 
40 PRINT 'SO IS MARY POPPINS." 
50 PRINT "DO YOU LIKE HER?" 
60 INPUT BS 
70 IF BS="YES" THEN 100 
80 PRINT "NEITHER DO I. SHE STILL OWES ME A DIME." 


90 STOP 

100 PRINT "I LIKE HER TOO. SHE IS MY MOTHER." 
110 STOP 

1000 PRINT "SO IS FRANKENSTEIN." 

9999 END 


When the user types RUN, the computer asks ARE YOU MALE OR FEMALE? Line 20 makes 
the computer wait for the user to reply; the reply is called A$. Jf A$ ts MALE, 
then the computer jumps from line 30 to line 1000, prints SO IS FRANKENSTEIN, and 
ends. If AS ts not MALE, the computer proceeds from line 30 to line 40, prints 
SO IS MARY POPPINS, asks DO YOU LIKE HER, waits for the user to reply, and prints 
an appropriate comment. 

In that program, lines 30 and 70 are decisions. Here's the flowchart: 


/PRINT "ARE YOU MALE OR FEMALE?" 
INPUT AS 
L = PRINT "SO IS FRANKENSTEIN." 
ni (6) 
RINT "SO IS MARY POPPINS. END 
PRINT "DO YOU LIKE HER?" 
/ INPUT B$ 
ax 
; zi i ae yes 1! | 
S="YES"} ee eT I LIKE HER TOO. SHE IS MY MOTHER." 
. | 
PRINT "NEITHER DO L. STOP 
/SKE STILL OWES ME A DINE.’ | 


CSTOP) | 


The program has three extts: two are marked STOP, and one is marked END. 
here are some other decisions the computer can make: | 


INSTRUCTION MEANING | 
IF X<=4 THEN 70 If X is less than or equal to 4, then jump to 70. | 
LE X>=4 THEN 70 If X is greater than or equal to 4, then jump to 70. | 
IF X<>4 THEN 70 If X isn't 4, thenyumpetoe70. 


IF X$<"CAT" THEN 70 If X$ is a word that comes before "CAT" in the dictionary, 
then jump to 70. 


Ls: 


Here's part of a program: 
30 INPUT X$ 
40 IF XS="YES" THEN 90 
If the user inputs YES, the computer will jump to line 90. 

Here's an improvement: 
30 INPUT xs 
40 IF xX$>="Y" THEN 90 
If the user types Y, or any word that comes after Y in the dictionary, the computer 
will jump to line 90. For example, if the user types YES or YESSIREE or ZOWIE or 
simply Y, the computer will jump to line 90. If the user types NO or NOSIREE or 
HUMPH or simply N, the computer won't jump to line 90. 

Congratulations! Now you know all the essential facts about programming. 
The rest of this book just fills in the details. 


DISKS 


While you are working on a program, the computer keeps it in core memory. 
It is erased from core memory when you type NEW (to begin a new program) or BYE. 
To store a program longer, put it on the computer's disks, which look like 
phonograph records. Here's how.... 

Suppose you type: 
NEW HARRY 
LO-PRINT "HI, BEAUTIFUL!” 
20 PRINT "YOU HAVE A SEXY NOSE!" 
30 END 
SAVE 
The word SAVE means: copy it onto a disk. If the computer succeeds, it says 
READY, and HARRY is in two places: in core memory, and on a disk. When you type 
NEW or BYE, the HARRY in core memory is erased, but the HARRY on the disk remains. 
The only way to erase HARRY from the disk is to type UNSAVE HARRY. If nobody 
ever types UNSAVE HARRY, the program remains on the disk for centuries. Unsave it 
when you no longer need it, to make room for programs that are more worthwhile. 

To see a catalog of what you've saved on disks, type: 
CATALOG 
The computer will print the name of every program you've stored. The word CATALOG 
can be abbreviated: 
CAT 


If HARRY is on a disk, and you'd like to use it, type: 
OLD HARRY 


To respond, the computer copies HARRY from the disk into core memory and says READY. 

HARRY is in two places: on a disk, and in core memory. Type LIST or RUN. If you 

retype some of the lines, you're changing just the copy in core memory. The only 

way to change the version on the disk is to type: 

REPLACE 

That replaces the disk's version by the newer version in core at the moment. 
Warning: suppose HARRY is on a disk, and then you write another program named 

HARRY and try to save it on disk also. The computer refuses to save the new HARRY, 

because it won't know which HARRY you mean if you later say OLD HARRY. So when 

you try to save the new HARRY, the computer doesn't say READY; instead, it gripes 

at you, by saying: 

DUPLICATE PROGRAM NAME. ‘HARRY ALREADY SAVED. REPLACE OR RENAME. 

That means the computer refuses to save your new HARRY. Type either— 

REPLACE 

or else— 

RENAME FRED 

SAVE 

If you type REPLACE, the computer replaces the disk's HARRY by the newer HARRY. If 

you type RENAME FRED and SAVE, your new HARRY is renamed FRED and then saved, so 

the disk has both FRED and the original HARRY. 
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Unfortunately, some computers use different terminology: 
MOST COMPUTERS CDC COMPUTERS HEWLETT-PACKARD COMPUTERS XEROX COMPUTERS 
NEW HARRY NEW, HARRY SCRATCH CLEAR 


NAME-HARRY 
SAVE SAVE SAVE SAVE OVER HARR 
CATALOG or CAT CAT CATALOG or CAT CATALOG or CAT 
OLD HARRY OLD , HARRY GET-HARRY CLEAR 
LOAD HARRY 
UNSAVE HARRY _PURCE,HARRY——CKILL-HARRY ss CDELETE HARRY | 
REPLACE REPLACE KILL-HARRY SAVE OVER HARR 
SAVE 


RENAME FRED RENAME , FRED=HARRY NAME —-FRED NAME FRED 
Programming a computer is like driving a car: the only way to become an 


expert is to put your hands on that mean machine and try it yourself. 

Put this book next to your terminal; every time you read a paragraph, try it: 
type the examples and look, look, see the computer run. Invent your own 
variations: try typing different numbers and strings. Write your own programs. 
Make the computer print your name or a poem. Make it solve problems from your 
other courses and the rest. of your life... The computer as a fantastic toy.. Play 
with it. 

Ifvyou're a student, don't wait for your instructor to ‘erve lectures land 
assign homework. Act now. You'll learn more from dealing with the terminal than 
from the lectures or readings. Experience counts. 

Let me tel leyow therestornyeorm Charlie. 02 

At Wesleyan University's computer center, one of the directors was having 
trouble making the computer print the university's payroll. He asked me for help, 
but 1 sayd’Prdidnt knew etther. M1 saw a ls ttlemieod 9st tting .. Geonemomert ne 


terminals. ‘Hey, Charlie," I called to him, "we're having trouble getting the 
payroll) ‘outn”’ 


Little Charlie came over and typed some stuff on our terminal. “The payroll 
will be out in a minute," he said gleefully. 
Charlie was only in seventh grade. He had never taken a computer course, 


because his school didn't offer one. But he had spent the whole summer just 
"hanging around'' our computer, and knew it better than we. 
Be like Charlie. Hang around your computer. Communicate with it every day. 


At first that will be even harder than. talkine with a cat or a tree, because the 
computer belongs to a different specie, a different kingdom; but keep trying. Get 
to know it as well as you know your best friend. 

When dealing with the computer and the people who surround it, be friendly 
but also aggressive. To make sure you get your money's worth from a computer 
course, ask your teacher and coworkers questions, questions, questions! 

If you're taking a French course, you might find French difficult; and if 
you're taking a computer course, you might find computers difficult also. But 
even a stupid three-year-old French kid can speak French, and even my second-graders 
can program the computer. They've got only one advantage over you: practice! 
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FOR... .NEXT 


Suppose you want the computer to print this: 
CATS 
DOGS 
CATS 
DOGS 
CATS 
DOGS 
CATS 
DOGS 
CATS 
DOGS 
CATS 
DOGS 
GROWL! 
This program does it: 
10 FOR N = 2 TO 7 
20 PRINT N'CATS" 
30 PRINT N"DOGS" 
40 NEXT N 
50 PRINT "GROWL!" 
60 END 
Line 10 tells the computer that N will be every number from 2 up to 7; to begin, 
N will be 2. Lines 20 and 30 make the computer print: 
2 CATS 
2 DOGS 
Line 40 makes the computer do it again, for the next N. The computer will print 
Similar sentences for N=3, for N=4, for N=5, for N=6, and for N=7. Then it will 
print GROWL and end. Here's the flowchart: 


SNNDDUOL HWW h DN 


PRINT N'CATS" 
PRINT N''DOGS"' 


PRINT ''GROWL!" 


The instructions between FOR and NEXT form a loop. The computer goes round and 
round the loop, for N=2, N=3, N=4, N=5, N=6, and N=7. Altogether, it goes around 
the loop 6 times; which is a finite number. Therefore, the loop is finite. The 
loop has only one exit, which is the arrow marked "no". 

To emphasize that the lines between FOR and NEXT form a loop, I've indented 
them in the program. The indentation is optional. On most computers, you can 
indent by holding down the CONTROL key, while you type an I. 
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10 FOR N = 3 TO 7 
20 PRINT Nt2 
30 NEXT N 


40 END 
Line 10 tells the computer that N will be every number from 3 up to 7; to begin, 


N will be 3. Line 20 makes the computer print 9. Line 30 makes the computer do 
the same thing over again for the next N, which is 4; so the computer will print 
16. The computer will print the square of every number from 3 up to 7, like this: 


If you'd rather see the square of every number from 1 to 100, change line 10 to this: 
10 FOR N = 1 TO 100 

This program prints twenty copies of the same message: 
10 FOR N = 1 TO 20 


20 PRINT "HUSH, HUSH!" 

30 PRINT " THERE WILL BE A SECRET MEETING..." 
40 PRINT " IN THE COMPUTER ROOM..." 

50 PRINT "' TONIGHT..." 

60 PRINT "' ATP OVA. Mes 

70 PRINT "' WEAR A FUNNY HAT." 

80 PRINT 

90 NEXT N 

100 END 


Line 80 leaves a blank line at the end of each copy, for your signature. 
This program plays a guessing game: 

LO2PRINT “DEL GIVE. YOU FIVE CUBSSE Oe. 

20 FOR N = 1 TO 5 


30 PRINT "WHAT'S MY FAVORITE COLOR?" 

40 INPUT GS 

50 IF GS$="PINK" THEN 100 

60 PRINT NOe. 

70 NEXT N 

80 PRINT "SORRY, YOUR FIVE GUESSES ARE UP!. YOU LOSE." 
90 STOP 


100 PRINT ''CONGRATULATIONS! YOU DISCOVERED MY FAVORITE COLOR." 
LLO UPRINT> “Lb erOOK. OU UN _CUG Solo em 
120 END 
Line 10 warns the user that only five guesses are allowed. Line 20 makes the 
computer count from 1 to 5; to begin, N is 1. Line 30 prints the question. Line 
40 waits for the user to input a guess, GS. If the user's guess is PINK, the 
computer jumps from line 50 to line 100, prints CONGRATULATIONS, and tells how many 
guesses the person took. But if the user's guess is not PINK, the computer 
proceeds from line 50 to line 60, prints NO, and goes on to the next guess. If the 
user guesses five times without success, the computer proceeds from line 70 to 
line 80 and prints SORRY: 4, YOU LOSE. 

For example, if the user's third guess is PINK, the computer prints: 
CONGRATULATIONS! YOU DISCOVERED MY FAVORITE COLOR. 
IT TOOK YOU 3-.GUESSHS 

If the user's very first guess is PINK, the computer prints— 
CONGRATULATIONS! YOU DISCOVERED MY FAVORITE COLOR. 
IT TOOK YOU 1 GUESSES: 
—which is ungrammatical but understandable. 
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Lines 20-70 form a loop. Line 20 says the loop will normally be done five times 
The line after the loop, line 80, is the loop's normal exit. But if the user happens 
to input PINK, the computer jumps out of the loop early, to line 100, which is the 
loop's abnormal extt. 

The FOR instruction can be varied: 
INSTRUCTION MEANING 
OReN =) 5°TO%17oSTereet N will be every number from 5 to 17, counting by tenths.| 
SOvNewiil be oO. other 5.1, then’s.2, then asso pete sirup 
N will be every third number from 5 to 17. 
be’ 5, then.8;..then 11, then i14, then <17. 
17 *TORSeS hrs —3 N will be every third number from 17 down to 5. SoN 
will be 17, then 14, then 11, then 8, then 5. 
To count down, you must use the word STEP. To count from 17 down to 5, give 
this instruction: 
FOR'N = 1L7fO25eSTEP -=1 

This program prints a rocket countdown: 
PONE ORYN' =44 O0'70RE STEP} 


5 TO)L7eSTEP!S So N will 


ie) 
ye) 
Zz 

i} 


20 PRINT N 
30 NEXT N 
40 PRINT "BLAST OFF!" 
50 END 
The computer will print: 
10 
9 
8 
7 
6 
5 
bs 
3 
yy) 
1 
BLAST OFF! 


PRINTING 


10 PRINT "EAT'3"MY"-7"DONUT" 

20 END 

The computer will print EAT, 3, MY, -7, and DONUT on the same line, like this: 
EAT 3 MY-7 DONUT 

The computer prints a blank space before every positive number, so there is a 


blank space before 3 but not before -7. The computer prints a blank space after 
every number, so there is a blank space after both 3 and -7. (Some computers 


print several blank spaces after each number.) 


10 PRINT 97/9 


20 END 
Line 10 tells the computer to divide 97 by 9 and print the answer. But the answer 
G3 1G. 0777777717711 1(1idiiiii..., and the computer can tiprintyinfinitely many 


sevens. When the computer prints a number, it usually prints) just the finst 6 
significant digits. So it prints: 
10.7778 
Notice that it rounds the last digit. 
The computer prints the complete number, instead of just the first 6 significant 


digits, if the number is an integer requiring no more than 8 digits. 
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10 PRINT ''MARY"; 

20 PRINT "BONES" 

30 END 

A semicolon makes the computer print the next item on the same line. The 
computer will print MARY, and will print BONES on the same line, like this: 
MARYBONES 


10 PRINT "UN"; "DER"; 

20 PRINT "WATER" 

30 END 

The computer will print UN, will print DER on the same line, and will print WATER 
on the same line also, like this: 

UNDERWATER 

The semicolon between "UN" and "DER" doesn't make any difference. If you omit the 
semicolon after '"DER'', the computer will print: 

UNDER 

WATER 


10 PRINT -10;-5;2 

20 END 

The computer will print -10, will:print —5 on the’ same line, and‘wrll*print 2%on 
the same line also, like this: 

= OF ph 

The computer prints a blank space after every number, so there is a blank space 
after -10, and after -5, and after 2 (which you can't see). Since 2 is positive, 
it prints an additional blank space before 2. In that program, the semicolons are 
important; if you omit them, the computer will compute -10-52 and print: 

=62 

If you replace the semicolons by blank spaces, the computer will print -62, since 
it ignores blank spaces. 


10 M=5 
20 E=3 
30 PRINT M;E 
40 END 
The computer will print: 
eye. 
The semicolon is important; if you omit it, the computer will gripe, since it 
doesn't know what ME is. 
Here's part of a program: 
10 PRINT 'WHAT IS YOUR NAME?" 
20 INPUT NS 
Line 10 makes the computer print WHAT IS YOUR NAME? Line 20 makes the computer 
print a question mark on the next line, and wait for input. If the user inputs JOE, 
the run will look like this: 
WHAT IS YOUR NAME? 
? JOE 
~ Here's an improvement: 
10 PRINT "WHAT IS YOUR NAME"; 
20 INPUT NS 
Line 10 makes the computer print WHAT IS YOUR NAME, without a question mark. Line 
20 makes the computer print the question mark; the semicolon at the end of line 10 
makes the question mark appear after NAME. If the user inputs JOE, the run will 
look like this: 
WHAT IS YOUR NAME? JOE 


JAN 


Here's how much you can fit on a line: 


IF YOUR COMPUTER USES THE DARTMOUTH SYSTEM IF YOUR COMPUTER USES THE PDP SYSTEM 
The terminal can print 75 characters on a The terminal can print 72 characters 
line. The 75 positions are numbered from on a line. The 72 positions are 
Lo) a eee, rer umbered from 0 to 71, 
This program tells the computer to skip to position 7, print JACK, then skip 
to position 42, and print JOE. 
10 PRINT TAB(7)"JACK"TAB(42)"JOE" 
20 END 
This program prints a parabola: 
POUREOR XS =o Grh One 


20 PRINT TAB(Xt2)''*" 
30 NEXT X 
40 END 


Line 10 says X will be every number from -8 to 8; to begin, X will be -8. Line 20 
Says to tab to position 64 and print a star, like this: 

Line 30 says to do the same thing over again, for X=-7; so the computer tabs to 
position 49 and prints a star, like this: 


ale 
7 


The computer will continue printing stars; here's the final picture: 


ray 


aL 
“ 


ale 
“ 


% 


ole 
“ 


al 
~ 


ae 
If you turn the paper 90° counterclockwise, you'll see a graph of Y=Xt2. If you 
change line 10 to say "FOR X = -12 TO 12", line 20 will: tell the computer .to tab 
144 spaces, which is impossible. You must scale down all graphs, so that they 
fit on the screen or the paper. 

Every line across your terminal's paper or screen is divided into 5 zones. 


IF YOUR COMPUTER USES THE DARTMOUTH SYSTEM LF “YOUR (COMPUTER “USES “THE PDP SYSTEM 
ach zone is 15 characters wide. In other} |Each zone has 14 characters, except 
yvords, the zones begin at positions 0, 15, the rightmost zone, which has 16. 

In other words, the zones begin at 

positions. 0,14, Zovec2. and 56. 

A comma makes the computer jump to a new zone: 

10 PRINT "cow",8,"DOGS", ,2;8+9, "MOTHER" 

20 END 

The computer will print COW in the first zone, 8 in the second, DOGS in the third, 

nothing in the fourth, 2 and 17 in the fifth, and MOTHER in the "sixth" zone, 

which is the first zone of the next line. Altogether, the computer will print: 

COW 8 DOGS RL 

MOTHER 


BOs cA wearide6 Owed, es bly 
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Warning: some computers don't allow adjacent commas; instead of ren they 


require ‘ 


10 PRINT “BILL”, 
20 PRINT ‘'MARY"', 
30 PRINT ''JOAN" 
40 PRINT "JACK" 
50 END 

The computer will print BILL in the first zone, MARY in the second, and JOAN in the 
third. JACK will be printed on a new line, since there is no comma or semicolon 


after "JOAN'. Altogether, the computer will print: 
BILL MARY JOAN 
JACK 


Here's a program for lovers: 
10 PRINT "LOVE", 


20760 T0410 

30 END 

The computer will print: 

LOVE LOVE LOVE LOVE LOVE 
LOVE LOVE LOVE LOVE LOVE 
LOVE LOVE LOVE LOVE LOVE 
Cicer 


If you replace the comma by a semicolon, the LOVEs will be closer together, like 
this: 
LOVELOVELOVELOVELOVELOVELOVE etc. 

Let's make the computer print this table: 


NUMBER SQUARE 
1 1 
2 4 
3 9 
4 16 
5 25 
6 36 
7 49 i 
8 64 
9 81 
10 100 


Here's the program: 
10 PRINT 'NUMBER", ''SQUARE" 
20 4EOR AN” 3 er aig 


30 PRINT N,Nt2 
40 NEXT N 
50 END 


Line 10 prints the word NUMBER at the top of the first column, and the word SQUARE 
at the top, of the second. Line 20 says) N will goiifrom lL’ to 10; to/bezin, N will 
be 1. Line 30 prints the number N in the first column, and N2 in the second. 

Line 40 does the same thing for the next N. If you'd like to see a longer table, 
change line 20 to this: 

20 FOR N = 1 TO 1006 
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DEBUGGING 


If you write your own program and run it, probably it won't work. Your first 
reaction will be to blame the machine; don't! The probability is 99.99% that the 


fault is yours. Your program contains an error. An error is called a Dugew popur 
next task is to debug the program, which means get the bugs out. 
Bugs are common; top-notch programmers make errors all the time. If you write 


a program that works perfectly on the first run and doesn't need debugging, aD 
called a gold-star program, and means you should have tried writing a harder one 
instead! 

It's easy to write a program that's almost completely correct, but hard to find 
the little bug that's fouling it up. Most of the time you spend in the computer 
center will be devoted to debugging. . 

To find the bug, ask the computer to help you.... 


Make the computer printeche entire program. lo Lopthat, itype: 
LIST 


Usually, the bug will turn out to be just _a_ typing error. Maybe you: 

Typed Oh instead of zero? ‘ 

Typed I instead of 1? 

Forgot to press the SHIFT key? 

Added an extra letter, or omitted a letter? 

Typed or erased a line you thought you hadn't? Maybe you pressed the LINE FEED 
instead of the CARRIAGE RETURN. 

Did you give an instruction that's illegal? Did you say COMPUTE instead of 
PRINT? Did you say SQR 9 instead of SQR(9)? Did you give a FOR command without 
a corresponding NEXT command? If you made such a mistake in line 40, the computer 
probably griped, by saying "blah-blah-blah kind of error IN LINE AOS 

Pretend you are the computer. Do what your program says. Do you find 
yourself printing the same wrong answers the computer printed? If so, why? 

In_your program, is there any instruction whose meaning you're not completely 
sure of? Check the meaning, by reading a book or asking a friend; or write a 
tiny experimental program that contains the instruction, and see what happens when 
you type RUN. 

If you run your program again, in exactly the same way, the computer will do 
exactly the same thing; you will learn nothing new. So before running the program 
again, make some changes. SAVE the current version of your program, and then 
make these changes: 

1. At the end of the program, make the computer PRINT the value of every 
variable, even the ones that seem unimportant. Then you can find out exactly 
what the computer is thinking. If you're still confused, make the computer print 
the value of every variable at several earlier points in the program. Remember, 
your job is to zero in on the bug. For example, if all the variables have the 
correct values halfway through the program, you know the bug is in the second half 
of the program, and you're halfway done finding it! 


2. Insert lines such as the following into your program: 
ASSPRINI 45 
Then the computer will tell you how many times it reached line 45. 
3. Delete some lines from your program, either by erasing them or by inserting 


a GO TO that skips over them. See whether the lines that are left are doing what 
they're supposed to. 
Remember...If the computer prints zero instead of the correct answer, it's 


because the variable you asked it to print is still undefined. 
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READ...DATA 


Whenever the computer sees the word READ, it hunts for DATA. 
10 READ X$ 
20 READ C$ 
30 READ FS 
40 READ X$ 
50 PRINT X$;F$ 
60 DATA ‘wel "DISLIKE, HER, “FATe! 


70 END 

Line 10 contains the word READ, so the computer hunts for DATA.” It reads the fires 
datum, "WE", and calls it X$. ‘So X$ is "WE". Line 20 says cS is the next datum, 
NNTSLIKE'. Line 30 says FS is the next datum; MHERM Line 40 says XS° is the next 
datum, FAT. Liné?50 prints: 

FATHER 


That program can be shortened. If a datum is a string that begins with a 
letter and contains no apostrophe, you can omit its quotation marks: 
60 DATA WE,DISLIKE ,HER, FAT 
Lines 10-40 can be combined into a single line: 
10 READ x$,C$,F$,X$ 
You don't have to put all the data on the same line; this is okay: 
60 DATA WE,DISLIKE 
6] DATA HER,FAT 
Each line of data should begin with the word DATA. 
The data can come anywhere in the program, but most programmers put Lt.at ore 
end, just before the END line. 
Suppose Joan, Sam, Robin, and Freddy send you presents. This program writes 


a thank-you note to each of them: 
10 READ NS 


20 PRINT "DEAR "NS$"," 

30 PRINT "' THANK YOU SO MUCH FOR THE PRESENT." 

40 PRINT "ACTUALLY, "NS", IT'S EXACTLY WHAT I HAD HOPED TO GET." 
50 PRINT "IT'S NICE TO HAVE A REAL FRIEND LIKE YOU, "NS$"." 


60 PRINT 

7O. ERIN 

eO.GO TO) 10 

90 DATA JOAN ,SAM, ROBIN, FREDDY 

100 END 

Line 10 reads the first datum, JOAN; so N$ is JOAN. Line 20 prints "DEAR " then 
JOAN then a comma. Line 30 prints " THANK YOU SO MUCH FOR THE PRESENT." Line 


40 prints “ACTUALLY, "™ then JOAN then eT TT SeEXACTEY WHAT "LY HAD HOPED = TOS Gis - 
Line 50 prints "IT'S NICE TO HAVE A REAL FRIEND LIKE YOU," then JOAN then a period. 
Altogether, the computer prints this Vetter, 

DEAR JOAN, 

THANK YOU SO MUCH FOR THE PRESENT: 
ACTUALLY, JOAN, IT'S EXACTLY WHAT I HAD HOPED TO GET. 
IT'S NICE TO HAVE A REAL FRIEND LIKE f, YOU, JOAN: 
Lines 60 and 70 make the computer leave some blank space, for your signature. 

Line 80 makes the computer go back and do it again; but this time line 10 reads 
SAM instead of JOAN. The computer types similar letters to Joan, Sam, Robin, and 
Freddy. Then it runs out of names to read and types: 

OUT OF DATA IN LINE 10 


* * * 
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Let's program the computer to give this quiz: 
WHAT IS THE CAPITAL OF NEVADA? 
WHAT IS THE CHEMICAL SYMBOL FOR IRON? 
WHAT WORD MEANS 'BROTHER OR SISTER'? 
WHAT WAS BEETHOVEN'S FIRST NAME? 
HOW MANY CUPS ARE IN A QUART? 
To make the computer score the quiz, we'll have to tell it the correct answers, 
which are: 
CARSON CITY 
FE 
SIBLING 
LUDWIG 
i 
So our program will contain this data: 
900 DATA WHAT IS THE CAPITAL OF NEVADA,CARSON CITY 
910 DATA WHAT IS THE CHEMICAL SYMBOL FOR IRON,FE 
920 DATA "WHAT WORD MEANS 'BROTHER OR SISTER''',SIBLIN 
930 DATA "WHAT WAS BEETHOVEN'S FIRST NAME", LUDWIG 
940 DATA HOW MANY CUPS ARE IN A QUART,"4" 
"WHAT WORD MEANS 'BROTHER OR SISTER'" is in quotation marks, because it contains 
an apostrophe. The same goes for ''WHAT WAS BEETHOVEN'S FIRST NAME". The string 
"4'' ig in quotation marks, because it begins with a digit instead of a letter. 


The lines are numbered 900, 910, 920, ... instead of 10, 20, 30, ..., because it's 
customary to put data at the end.of the: program. “We'll have: 
999 END 


All we have left to do is figure out what should come before line 900. Let's 
write the program, a line at a time.... 

Tosbegin,, the progrvameshould, print the first,question?. “Io“’print it, the 
computer must read it from the data: - 
10 READ Q$ 
20 PRINT Q$ 
That makes the computer print WHAT IS THE CAPITAL OF NEVADA. 

We want the person taking the quiz to try to answer the question, by inputting 
a response: 

So far, our program does this: 
RUN 
WHAT IS THE CAPITAL OF NEVADA 
9 
It would be nicer to have the question mark come right after NEVADA, instead of on 
a separate line. To do that, we must eliminate the carriage return after NEVADA. 
That means putting a semicolon in line 20: 
Now our program does this: 
RUN 
WHAT IS THE CAPITAL OF NEVADA? 

We have to compare the person's response (R$) against the correct answer, 
which is in the data: 


40 READ A$ 
50 IF RS=AS$S THEN 100 


Line’ 40 reads the correct answer from the data, and calls it A$. Line 50 says that 
if the person's response (R$) is the correct answer (A$), jump to line 100. Line 100 
should print CORRECT and then move on to the next question: 

100 PRINT "CORRECT" 

110-GO T@ 10 

But if the person's response (R$) is not the correct answer (A$), the computer goes 
from line 50 to line 60: 


60 PRINT "NO, THE ANSWER IS: "AS 
70 GO TO 10 
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Altogether, our program looks like this: 
10 READ Q$ 
20 PRINT QS; 
30 INPUT RS 
40 READ A$ 
50 IF RS=AS$ THEN 100 
60 PRINT "NO, THE ANSWER IS: "AS 
7E2GORTO 2h0 
100 PRINT "CORRECT" 
110 GO TO 10 
900 DATA WHAT IS THE CAPITAL OF NEVADA,CARSON CITY 
910 DATA WHAT IS THE CHEMICAL SYMBOL FOR IRON,FE 
920 DATA "WHAT WORD MEANS 'BROTHER OR SISTER''' ,SIBLING 
930 DATA "WHAT WAS BEETHOVEN'S FIRST NAME", LUDWIG 
940 DATA HOW MANY CUPS ARE IN A QUART,"4" 


999 END 
Here's a sample run: 
RUN 


WHAT IS THE CAPITAL OF NEVADA? LAS VEGAS 
NO, THE ANSWER IS: CARSON CITY 
WHAT IS THE CHEMICAL SYMBOL FOR IRON? FE 
CORRECT 
WHAT WORD MEANS 'BROTHER OR SISTER'? I GIVE UP 
NO, THE ANSWER IS: SIBLING 
WHAT WAS BEETHOVEN'S FIRST NAME? LUDVIG 
NO, THE ANSWER IS: LUDWIG 
HOW MANY CUPS ARE IN A QUART? 4 
CORRECT 
OUT OF DATA IN LINE 10 
To give a quiz about different topics, change lines 900-940. 
Instead of making the computer print OUT OF DATA IN LINE 10, it would be 
cheerier to print HOPE YOU ENJOYED THE QUIZ: 
[200 PRINT "HOPE YOU ENJOYED THE QUIz"| 
But how do we make the computer jump to line 200 when it reaches the end of the 
data? The trick is/to put°an X at thejend of the data — 
(980 DATA X| 
—and make the computer jump to line 200 when it reaches the X—-in other words, 
when the Q$ it reads is "X": 
fi5 IF Q$="X" THEN 200 
Now our program looks like this: 
10 READ Q$ 
+15 IF Q$="X" THEN 200 
20 PRINT QS; 
30 INPUT R$ 
40 READ A$ 
50 IF RS=AS$ THEN 100 
60 PRINT "NO, THE ANSWER: IS: ‘AS 
70 GO TO 10 
100 PRINT "CORRECT" 
110 GO TO '10 
+200 PRINT "HOPE YOU ENJOYED THE OULZ 
900 DATA WHAT IS THE CAPITAL OF NEVADA,CARSON CITY 
910 DATA WHAT IS THE CHEMICAL SYMBOL FOR IRON, FE 
920 DATA "WHAT WORD MEANS 'BROTHER OR SLSTER’ ) SIBLING 
930 DATA ''WHAT WAS BEETHOVEN'S FIRST NAME'', LUDWIG 
940 DATA HOW MANY CUPS ARE IN A QUART, "4"! 
+980 DATA X 
999 END 
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The X in line 980 is called a trailer, since it is a fake datum that trails after 
the real data. At the end of the run, the computer will print HOPE YOU ENJOYED 
THE QUIZ instead of OUT OF DATA IN LINE 10. 

Let's have the computer count how many questions the person answers correctly. 
The number of questions the person answers correctly we'll call C. Each time the 
person answers a question correctly, we want to increase C, by adding 1 to it. So 
we need a line saying C=C+l. We want the computer to do that line only if the 
person answers a question correctly. Since the computer gets to lines 100-110 only 
if the f the person answers correctly, we'll number the line 105: 
(1 05 C=C+l| 
At the end of the run, instead of printing just HOPE YOU ENJOYED THE QUIZ, we'll 
have it also print C: 
[200 PRINT "YOU'VE ANSWERED"C"OF THE QUESTIONS CORRECTLY." 
|210 PRINT "HOPE YOU ENJOYED THE QUIZ." 

Line 200 prints a message such as: 
YOU'VE ANSWERED 2 OF THE QUESTIONS CORRECTLY. 
It would be nicer to print— 
YOU'VE ANSWERED 2 OF THE 5 QUESTIONS CORRECTLY. 
YOUR; SCORE 1S 40°72; 
—or, if the quiz were changed to include 8 questions: 
YOU'VE ANSWERED 2 OF THE 8 QUESTIONS CORRECTLY. 
WOGR SCORE *Lou20 84. 
To make the computer print the 5 or the 8, we'll have to make it count the number 
of questions. Let Q stand for the number of questions. Each time the computer 
reads a question, we want it to increase Q. We need a line saying Q=Q+l. We want 
the computer to do that line if it reads an honest-to-goodness question, but not 
if it reads the X. So we stick the line shortly after the line that reads 


uestions (line 10), but also after the line that checks X (line 15): 
L7 QQ 


We make line 200 print Q: 
i200 PRINT YOU'VE ANSWERED ''C'OF TH THE''Q''QUESTIONS CORRECTLY. | wi 


And we make the next line print the percentage: 
bos PRINT "YOUR SCORE IS"C/Q*100"%. } 
Altogether, here's the final versfon: 
10 READ Q$ 
15 IF Q$="X" THEN 200 
+17 Q=Qtl 
20 PRINT QS; 
30 INPUT RS 
40 READ AS 
50 IF RS=AS THEN 100 
60 PRINT ''NO, THE ANSWER IS: "AS 
70 GO TO 10 
100 PRINT "CORRECT" 
#105 C=C+1 
110 GO TO 10 
>200 PRINT “YOU'VE ANSWERED"C"OF THE'Q"QUESTIONS CORRECTLY." 
+205 PRINT "YOUR SCORE IS"C/Q*100"%."' 
+210 PRINT “HOPE YOU ENJOYED THE QUIZ." 
900 DATA WHAT IS THE CAPITAL OF NEVADA,CARSON CITY 
910 DATA WHAT IS THE CHEMICAL SYMBOL FOR IRON,FE 
920 DATA "WHAT WORD MEANS ‘BROTHER OR SISTER''', SIBLING 
930 DATA "WHAT WAS BEETHOVEN'S FIRST NAME", LUDWIG 
940 DATA HOW MANY CUPS ARE IN A QUART,"'4" 
980 DATA X 
999 END 
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If you say RESTORE, the computer goes back to the beginning of the data: 
10 READ AS$,BS 


20 RESTORE 

30 READ C$ 

40 PRINT C$ 

50 DATA APPLE, PEAR, ORANGE 

60 END 

Line 10 reads APPLE and PEAR. Line 20 makes the computer go back to the beginning 
of the data, so line 30 reads APPLE again instead of ORANGE. Line 40 prints APPLE. 


* * + 


Let's program the computer to translate colors into French. For example, if 
the person inputs RED, we'll have the computer say ROUGE. 
We'll have to feed the computer the data: 
ENGLISH FRENCH 
WHITE BLANC 
YELLOW JAUNE 
ORANGE ORANGE 


RED ROUGE 
GREEN VERT 
BLUE BLEU 
BROWN BRUN 


BLACK NOIR 


910 DATA BLUE,BLEU,BROWN,BRUN, BLACK, NOIR 
999 END 


The program begins simply: 
10 PRINT ''TYPE A COLOR IN ENGLISH" 
20 INPUT CS 


If the person inputs RED, we want the computer to search through the data, 
until it finds the pair RED,ROUGE. More generally, if the person inputs C$, we 
want the computer to search through the data, until it finds an English-French 
pair (E$,FS), where ES=CS: 

30 READ ES,FS 

407 LE VE S<>CS° THEN? 30) 

Line 30 reads an English-French pair. Line 40 says: if E$#C$, go back to 30 and 
read another pair. Lines 30 and 40 form a loop; the computer does them again and 
again, until it finally finds the right English-French pair. 

We want it to print the French: 

50 (PRINT SES 


Altogether, our program looks like this: 
10 PRINT UTYPE A COLOR IN ENGLISH" 
20 SNPUTSECs 
30 READ ES$,F$ 
40 IF E$<>CS THEN 30 
50 PRINT FS 
900 DATA WHITE, BLANC, YELLOW, JAUNE , ORANGE , ORANGE , RED, ROUGE ,GREEN ,VERT 
910 DATA BLUE ,BLEU,BROWN,BRUN, BLACK ,NOIR 
999 END 
Here's a sample run: 
RUN 
TYPE A COLOR IN ENGLISH 
2? RED 
ROUGE 
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Here's another run: 
RUN 
TYPE A COLOR IN ENGLISH 
? BROWN 
BRUN 

Here's another: 
RUN 
TYPE A COLOR IN ENGLISH 
TOPPING 
OUT OF DATA IN LINE 30 

The computer says OUT OF DATA IN LINE 30 because it can't find PINK in the 
data. Instead of saying OUT OF DATA IN LINE 30, it would be nicer to say I WASN'T 
TAUGHT THAT COLOR. 

We want the computer to say I WASN'T TAUGHT THAT COLOR, when it reaches the 
end of the data. To do that, we use the same trick as in the quiz program: we 
utla trailers xX vat) the-end of the data— 
[980 DATA X,''I WASN'T TAUGHT THAT COLOR" 
and make sure that when the computer reaches the X, it prints I WASN'T TAUGHT THAT 
COLOR: 
Line 35 says: if what the computer reads (E$) equals "X'', then jump to line 50 
(which prints F$, which is I WASN'T TAUGHT THAT COLOR). 

After line 50, the program just ends. It would be more useful to have the 


computer jump back to the beginning and translate another color: 
[60 GO TO 19 


When the computer goes back to line 10 and tries to translate a new color, 
we want it to search through the data again, like it did the first time. We want 
the search to begin at the beginning of the data—not where the previous search 
left off. To make the computer look at the beginning of the data again, we have 
to give the command RESTORE. There are several places you could put it; but if 
you get in the following habit, your chance of making an error will be decreased: 
put RESTORE immediately before the READ it refers to. Since our RESTORE refers to 
the READ in line 30, put: 

[29 RES TORE| 

Altogether, here's the final version: 
10-PRINT ''TYPE A COLOR IN ENGLISH" 
20 INPUT CS 

+29 RESTORE 


30 READ E$,F$ 
+35 IF ES="X" THEN 50 Vw 
40 IF ES$<>C$ THEN 30 


50 PRINT FS 

+60 GO TO 10 

900 DATA WHITE, BLANC, YELLOW, JAUNE , ORANGE , ORANGE , RED ,ROUGE ,GREEN , VERT 
910 DATA BLUE,BLEU, BROWN ,BRUN ,BLACK, NOIR 

+980 DATA X,""I WASN'T TAUGHT THAT COLOR" 

999 END 
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Here's a sample run: 
RUN 
TYPE A COLOR IN ENGLISH 
? RED 
ROUGE 
TYPE A COLOR IN ENGLISH 
? BROWN 
BRUN 
TYPE A COLOR IN ENGLISH 
? PINK 
I WASN'T TAUGHT THAT COLOR 
TYPE A COLOR IN ENGLISH 
? BLUE 
BLEU 
TYPE A COLOR IN ENGLISH 
2? YELLOW 
JAUNE 
etc. 
The program keeps looping, until you abort it. 


# 4 * 
Suppose you want to square many numbers. This program does the job: 
10 INPUT X 
20 PRINT Xt2 
99 END 
But it requires you to type RUN every time you want to square a new number. If 


you want to square a hundred numbers, you have to type RUN a hundred times, which 
is very annoying. 
This program 1S an improvement: 

LO INP Xx 
20 PRINT X*t2 

+30 GOcTOsLO 
99 END 
Now you have to type RUN only once. But the program is still slow: when the 
computer encounters the INPUT statement, it prints a question mark on your terminal, 
then switches its attention to the other terminals; when you've inputted the 
number and pressed the carriage return, you must wait a few seconds for the 
computer to return its attention to you. If you are inputting a hundred numbers, 
the wait after each input is annoying. 


This program runs more quickly, with no waiting: 
710 READ X 


ZOAPRIEND Ra? 
30 GO TO 10 
+40 DATA 42,7.35,100.1,etc. 
99 END 
In line 40, type the numbers you want to square. If they don't all fit in one line, 
continue with 
50 DATA etc. 
60 DATA etc. 
70 DATA etc. 


In addition to its lightning speed, this program has another nice feature: if you 
want a second copy of the results, just type RUN again. For the program that used 


INPUT, if you wanted a second copy, you'd have to type not only RUN but also the 
hundred numbers again. 
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To make the computer print the answers in the form of a table, change line 20: 
10 READ X 
+20 PRINT X,X+2 


30 GO TO 10 
40 DATA 42,7.35,100.1l,etc. 
50 DATA etc. 
60 DATA etc. 
70 DATA etc. 
99 END 
The computer will print: 
42 1764 
| tee 54.0225 
OOS) 10020. 
etc 


Data, like input, must be constants. For example, you can say— 
80 DATA .66666667 


—pbut not: 
80 DATA 2/3 


FUNCTIONS 


SQR is just one of the many functions you can use. 

If you understand trigonometry and know what a radian is, you can use these 
functions: 
COMPUTER SYMBOL MEANING 


[SINCX) eerie Of X tadians ei. is, Oe? ie RP ae ee! 
iCOS(X) the COSine of X radians 

TAN(X) the TANgent of X radians 

iATN(X) the ArcTaNgent of X, in radians; in other words, the number 


whose tangent is X 
Some computers alsa allow COT(X) , which means the COTangent of X radians. 
If you understand calculus aye know what the number @€ is, you can use these 
functions: 
COMPUTER SYMBOL MEANING 


EXP (X) Be tan 

HLOG(X) the natural LOGarithm of X; in other words, log, XQ whichi-ts 
so SaaS in Xx | 1 UL AES pelea ie SEA a eS : 

Some computers ‘also allow IGT) which means the LoGarithm base Ten of +e “which 
is log,, X . Warning: when a high-school math book says "log X", it means LGT(X), 
not LOG(X). 


If you understand neither trigonometry nor calculus, that's okay: you can 
ignore those functions, or, if you're curious, read the Commentary. 

Sometimes the computer's answer is too accurate, and you'd prefer a rougher 
one. Here's how to get it: 
COMPUTER SYMBOL MEANING 


INT(X) X rounded down to an INTeger; for example, INT(17.9) is 17; | 
Cet LC Soe Len Oe SUN EC a4) Bis) DAM aS 


iG 9 eglliagian rs the ABSolute Gate Gi UC sahnOuileLr words, X without its minus 
! Siete Om example, ABOC7 242) 18 9,2; ABS(9.3) as ..9.3 
SGN(X) the SiGN of X; more precisely: if X is negative, SGN(X) is -l; 


Lt as ooaee SGNUX ule oe ir mas zero, SGN(X) is) zero 
Most computers also provide functions that tell you the time, and functions 
that manipulate strings. For details, see the Commentary. 


+ * + 
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The strangest function is RND. Here's how it works on PDP-10 computers; I'11 
discuss other computers afterwards... 

RND is a RaNDom decimal, bigger than 0 and less than 1. For example, it might 
be .627564 or .924158 or .263284. Every time your program mentions RND, the computer 
concocts another decimal: 

10 PRINT RND 
20 PRINT RND 
30 PRINT RND 


99 END 

The computer prints: 

OmAIi Sie 

0.696209 

On297 52 

The first time your program mentions RND, the computer chooses its favorite decimal, 
which is 0.217873. Each succeeding time your program mentions RND, the computer 
uses the previous decimal, to concoct. a new one. “it uses 021/675 eto-concocrE 


0.696209, which it uses to concoct 0.29751. The process by which the computer 
concocts each new decimal from the previous one is weird enough so we humans cannot 
detect any pattern. 
This program prints ten thousand decimals: 
>10 FOR N = 1 TO 10000 


20 PRINT RND 
+30 NEXT N 
99 END 


About half the decimals will. be less than <5, and about half willbe more-—thanwo: 
Most. of the decimals will be less than .9-—in fact, about 902° will be-~ Aboute36. 
o£ the-decimals-wili- be-Less than-<36;~-592% will be less than, 597-2997 wrll-vpestese 
than. .99; 24 will be less than 702; a quarter. of -themiwill beetess than 2 eer 
You might see some decimal twice, though most of the decimals will be different 
from each other. 

If you run that préeram again, you'll get exactly the- same list of decimate 
again, in the Same order. 

If you'd rather see a different list, say RANDOMIZE at the beginning of the 
program: 

+] RANDOMIZE 

10 - FOR N= 11. FO LOQGO 


20 PRINT RND 
30 NEXT N 
99 END 


When the computer sees RANDOMIZE in line 1, it looks at the clock, and manipulates 
the. fime's digits to produce the first) value of RND. | Southemiirst vale or ghy 
will be a number that depends on the time of day, instead of the usual 0.217873. 
Since the first value of RND will be different than usual, so will the second, 7 ana 
so. will ‘the rest of tie liom 

Every time you run the program, the clock will be different, so the first 
value of RND will be different, so the whole list will be different—unless you 
run the program at exactly the same time the next day, when the clock is the same. 
But since the clock is accurate to a tiny fraction of a second, the chance of 
hitting the same time is extremely unlikely. 
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10 RANDOMIZE 

20 PRINT "TYPE THE NAME OF SOMEONE YOU LOVE." 

30 INPUT NS 

40 IF RND<.67 THEN 100 

50 PRINT NS" HATES YOUR GUTS." 

60 GO TO 20 

FOUSPRINT NS'ESLOVES =1OU,, sL00. 

POL GOeTO220 

120 END 

Line 10 says the value of RND will depend on the clock. Lines 20 and 30 make 

the computer wait for the user to type a name. Suppose he types SUZY. Then NS 

is SUZY. When the computer reaches line 40, there is a 67% chance it will jump 

to line 100 and print SUZY LOVES YOU, TOO; but there is a 33% chance it will proceed, 
instead to line 50 and print SUZY HATES YOUR GUTS. Lines 60 and 110 make the 
computer do the routine again and again, until the user gives an abortion. The 

run might look like this: 

RUN 

TYPE THE NAME OF SOMEONE YOU LOVE. 
ISUZY 

SUZY LOVES YOU, TOO: 

TYPE THE NAME OF SOMEONE YOU LOVE. 
? JOAN 

JOAN HATES YOUR GUTS. 

TYPE THE NAME OF SOMEONE YOU LOVE. 
TA ATT GE 

ALICE LOVES YOU, TOO. 

TYPE THE NAME OF SOMEONE YOU LOVE. 
2? FRED 

PRED LOVES YOU, TOO. 

TYPE THE NAME OF SOMEONE YOU LOVE. 
? UNCLE CHARLIE 

UNCLE CHARLIE HATES YOUR GUTS. 
SEQ L 


in vou wanthacnandem mtecern fromulisto 10. askifor 1+INT(RND*10). Here's 


RND is a decimal, bigger than 0 and less than 1. | 
So RND*10 is a decimal, bigger than 0 and less than 10. 
So INT(RND*10) is an integer, at least zero and no more than 9 | 
So 1+INT(RND*10) is an integer, at least 1 and no more than 10, 
This program plays a game: 
10 RANDOMIZE 
20 PRINT "I'M THINKING OF A NUMBER FROM 1 TO 10." 
30 N=1+INT(RND*10) 
40 PRINT ''GUESS MY NUMBER." 
50 INPUT G 
60 PRINT ''MY NUMBER WAS"'N 
70 IF G=N THEN 100 
80 PRINT "HA, HA, YOU LOSE $1." 
90 GO TO 30 
100 PRINT ''CONGRATULATIONS! YOU WIN $10. LET ME SHAKE YOUR HAND." 
LLORGOSTO 230 
120 END 
Lines 10-20 start the game. Line 30 makes the computer think of a random integer 
from 1 to. 10; the computer calls it N. Lines 40-50 wait for the user to guess; 
the guess is called G. Line 60 reveals N. If G is the same as N, the computer 
jumps from line 70 to line 100 and prints CONGRATULATIONS...; if G is not the same 
as N, the computer prints HA, HA,... Lines 90 and 110 make the computer repeat. 
Here's a sample run: 
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I'M THINKING OF A NUMBER FROM 1 TO 10. 
GUESS MY NUMBER. 
5 
MY NUMBER WAS 7 
HASYHAS YOU“LOSE SP. 
GUESS MY NUMBER. 
ie: 
MY NUMBER WAS 2 
HA, HA, YOU LOSE $1. 
GUESS MY NUMBER. 
2.8 
MY NUMBER WAS 8. 
CONGRATULATIONS! YOU WIN $10. LET ME SHAKE YOUR HAND. 
GUESS MY NUMBER. 
etc. 
That's what happens on PDP-10 computers. On others, the favorite number might 
not be 0.217873, and the notation might be different: 
MOST COMPUTERS XEROX COMPUTERS CDC COMPUTERS HEWLETT-PACKARD COMPUTERS 
__RNDCO) ____RND(O) 


R=RND(1)  R=RND(CLK(O)) not needed—the computer 
__clways randomizes 


* + * 


Notice that the name of every function has three letters: SQR, SIN, COS, 
TAN ,. ATN, «COTS EXP LOG }.LGTy» INT, ABS, “SGN, and RNDw) Tiiwourtdontt Wikemthose 
functions, you can invent your own. The name of your FuNction must have three 
letters also, and the first two letters must be FN. So the name of your function 
can be FNA or FNB or FNC etc; you have 26 names to choose from. 


10 DEF FNA(X)=Xt2+1 

20 PRINT FNA(8) 

30 B=7+FNA(100) 

40 PRINT B=3 

50 END 

Line 10 DEFines “FNA(X) "to«be X42+1, for everysXs! line'i20 siays.to print FNACS), 
which) 1s 842+), which is, 65; so the computer prints’ 65... line 30 Says ous 
7+FNAC100), which is 7+10012+1,. which is 10008) “Gaine 40rprints, OOS: 


LOOP TECHNIQUES 


This program makes the computer imitate an adding machine: 
10 T=0 
20°-PRINT: “NOW “LHe *TOTAERESY T 
30 PRINT "WHAT NUMBER DO YOU WANT TO ADD TO THE TOTAL"; 
4O INPUT X 
50 T=T+X 
60 GO TO 20 
70 END 
Throughout the program, T represents the Total. Line 10 makes T begin at 0, so 
line 220 iprants: 
NOW THE TOTAL IS 0 
Lines 30 and 40 print: 
WHAT NUMBER DO YOU WANT TO ADD TO THE TOTAL? 


The computer waits for the person to input a number X. Line 50 says: the new Total 
will be the previous Total plus X. In other words, the Total will be increased, by 
adding X to it. Line 60 makes the computer repeat those instructions endlessly; 


here's a sample run: 
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RUN 

NOW THE TOTAL IS 0 

WHAT NUMBER DO YOU WANT TO ADD TO THE TOTAL? 5 
NOW THE TOTAL IS 5 

WHAT NUMBER DO YOU WANT TO ADD TO THE TOTAL? 3 
NOW THE TOTAL IS 8 7 
WHAT NUMBER DO YOU WANT TO ADD TO THE TOTAL? 6.1 
NOW THE TOTAL IS 14.1 

WHAT NUMBER DO YOU WANT TO ADD TO THE TOTAL? -10 
NOW THE TOTAL IS 4.1 

CEC. 


This program adds together all the integers from 7 to 100: 
10 T=0 
20 FOR X = 7 TO 100 
30 T=T+X 
40 NEXT X 
50 PRINT T 
60 END 
finewlO says, tne totalsstarts: at 0. Line 20 says.X:will :eo.from,/7. to,100...., Line 
bU increases: theslotaljeby adding each™X to 1t.~ -Line 50 prints, the final,Total, 
which is 5029. +e 
This program adds together the square of each integer from 7 to 100; in other 
words, it computes 77+82+92+...+1002: 
10 T=0 
20 FOR X = 7 TO 100 


+30 T=T+X42 


40 NEXT X 
50 PRINT T 
60 END 
It's the same as the previous program, except that line 30 says to add X* instead 
Gir xX. 
This program adds together the numbers in the data: 
10 T=0 
20 READ X 
30 IF X=0 THEN 100 
40 T=T+X 
SO5GO,TO).20 
BOOSERINT: FT 
900 DATA 5,3,6.l,etc. 
910 DATA etc. 
920 DATA etc. 
930 DATA 0 
940 END 
Lines 900, 910, and 920 contain the numbers to be added. The zero in line 930 is 
a trailer that marks the end of the data. The computer begins the program by doing 
fanerlOs which starts the Total @ateecerows tine 20 reads an X fromthe: data. Lf the 
X it reads is zero, the end of the data has been reached, so we want the computer 
to jump from line 30 to line 100 and print the Total; but if the X it reads is not 
zero, the computer proceeds from line 30 to line 40, adds the X to the Total, and 
goes from line 50 to line 20, which reads another X. 
All those programs used the same technique: 
ilo add numbers together, 
egin by saying T=0, 
and then have a loop containing this kind of statement: 
T=T+something 
You can make the loop by using either GO TO or FOR...NEXT. 
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Multiplication is similar: 
To multiply numbers together, 
begin by saying T=1, 
and then have a loop containing this kind of statement: 
T=T*s ome thing 
Here's an example: 
10 ©T=1 
20 PRINT "NOW THE TOTAL IS'"'T 
30 PRINT "WHAT DO YOU WANT TO MULTIPLY THE TOTAL BY"; 
40 INPUT X 
50 T=T*X 
60°GOTO. 20 
70 END 
The run looks like this: 
RUN 
NOW THE TOTAL IS 1 
WHAT DO YOU WANT TO MULTIPLY THE TOTAL BY? 
NOW THE TOTAL IS 7 
WHAT DO YOU WANT TO MULTIPLY THE TOTAL BY? 
NOW THE TOTAL IS 14 
WHAT DO YOU WANT TO MULTIPLY THE TOTAL BY? ie) 
NOW THE TOTAL IS-140 
ekC. 
For multiplication, the Total should start at 1, not 0; because if you start at 
T=0, the run is boring: 
NOW THE TOTAL IS 0 
WHAT DO YOU WANT TO MULTIPLY THE TOTAL BY? 
NOW THE TOTAL IS 0 
WHAT DO YOU WANT TO MULTIPLY THE TOTAL «BY? 
NOW THE TOTAL IS 0 
WHAT DO YOU WANT TO MULTIPLY THE TOTAL BY? at 
NOW THE TOTAL IS 0 
GHEE « 


IN 


Ino 


JIN 


Iho 


The factorial of 4 is 1*2*3*4; the factorial of Jf 18 1*2*344"5~6*/2 to rand 
the factorial of any number N, multiply together all.the integers from 1] to N. 
This, program finds. the factorial of any number: 
10 PRINT "WHAT NUMBER DO YOU WANT TO FIND THE FACTORIAL OF"; 
20 INPUT N 
30 T=1 
40 FOR X 
50 T= 
60 NEXT X 
ZLOP PRIN T 
80 END 
Lines 10-20 wait for the user to input a number N. Lines 30-60 multiply together 
all’ the integers from i to N. “line /0 prints the tinal ota. 


Yes, Virginia, computers can count. Let's make the computer print; 

0 

1 

Za 

3 
etc. 
Notice that each number is 1 more than the previous number. (How profound!) Here's. 
the veneral technique: 2.4 | ee aS Tare eo! 
Lo..count , 


begin by saying T=0, 
and then have a loop containing this statement: 
T=T+1 


a7 


Here's the program: 
10 T=0 
20° PRINT T 
30 T=T+1 
40 GO TO 20 
50 END 

Suppose you input several values of X and want the computer to find the 
biggest. To begin, set T equal to a very low number, such as -1E38. Compare 
eechexsacainest ls Sachetime, you. find an Xibigger than JT, increase T, soit is.*as 
big as the X. When you're done, T will be the biggest X. Here's the program: 


PROGRAM COMMENT 
10 T=-1E38 Set T equal to a very Low wumber. 
20 PRINT "TYPE A NUMBER" |oo4 0) x 
30 INPUT X ; 
40 IF X<=T THEN 100 Compare X with T. If X 44 bigger, de 50; 44 not, do 100. 
50 T=X 14 X 48 bigger, increase T, 40 Lt 44 as big as the X. 
100 PRINT "THE BIGGEST NUMBER YOU'VE TYPED SO FAR IS"T 
110 GO TO 20 Repeat the process for each X. 
120 END 
the run looks tikerthis: 
RUN 
TYPE A NUMBER 
2-5 


THE BIGGEST NUMBER YOU'VE TYPED SOLFAR LS—5 

TYPE A NUMBER 

7829 

THE BIGGEST NUMBER YOU'VE TYPED SO FAR IS 29 
TYPE A NUMBER 5 

eee 

THE BIGGEST NUMBER YOU'VE TYPED SO FAR IS 29 
TYPE A NUMBER 


etc. 
If you want to find the smallest instead of the biggest, the changes are minor: 
+10 T=1E38 Set T equal to a very high number. 
20 PRINT "TYPE A NUMBER"! poor ney 
30 INPUT X ; 
+40 IF X>=T THEN 100 Compare X with T. I4 X 44 smaller, do 50; 44 not, do 100. 
50 T=X 1h X 45 smaller, decrease T, 40 (t 45 as AmalL as the X. 
+100 PRINT ''THE SMALLEST NUMBER YOU'VE TYPED SO FAR IS"T 
| £10 GO: TO. 20 Repeat the process for each X. 
120 END 
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SUBSCRIPTS | 
If your program involves a list or table, you may find this notation helpful.... 
ab * 


Instead of being a single number, X can be a whole Ztst of numbers: 


8 

25 
ae 

cad 
This program does it: 
10 DIM x(4) 
ZUPXGLJ=S 
30,402) =21 
eax (3) = 235 1 
SOek (4)e-9 
60 MAT PRINT X 
70 END 


Line 10 says X will be a list of 4 numbers. Line 20 says the first value of X is 
8. Line 30 says the second value is 21. Lines 40 and 50 give the third and fourth 
values. Line 60 prints all the values of X, like this: 

8 

21 

23 EF 
<9 

The numbers in parentheses are called subscripts. Line 20 is pronounced, 

ity enh d ie Sl veettin. maths booke, & sup els Lowwrd Eten: X, 


Line 10 tells the list's size, which is’ also called the list's DiMension. 

im that program, .X has subscripts. Jin lane ZO@eits subscript is 1; in line 
30, its subscript is 2; etc. A variable that has subscripts 1s called a WET ice 
Line 60 says: the MATrix to be PRINTed is X. 


* * % 


You can do fancy things: 
10 DIM Y(5) Y will bea List of 5 numbers. 
20 FORM =n2, 1005 
30 Y¥(I1)=1*100 Y(2) is 200. Y(3) 48 300. YI(4) xs 400. Vis lec sor 
40 NEXT I 
50 ¥(1)=¥(2)-3 V (Tbe eer 97 
WO Che 1G View ¥(3) changes; 4t becomes 195. 
70 MAT PRINT Y Print Vb) Pave? AY (3 eV a eandeyilio): 
80 END 
Line 70 prints: 
Ue) 
200 
E95 
400 
500 
In line 60, instead of saying Y(3), you can say Y(1+1+1) or Y¥(7+2-46) or Y(N), 
if you previously define N to be 3. But that kind of fooling around is not allowed 


in line 10: in the DIM statement, the subscript must be a constant. You can say 
DIM Y(5), but not DIM Y(4+1) or DIM Y(L). 


+ * % 


Instead of lists, you can have tables: 
be ( Bia Bh ab 
1000". .0 hg 
This program creates that table Z: 
TOL DIMI 2.0223) 
2002 (51 )=57 
30 Z(1,2)=8.4 
40 Z(1,3)=-6 
50 Z(2,1)=1000 
60 Z(2,2)=0 
POSZC2 3) "7/7 / 
80 MAT PRINT Z 
90 END 
Line 10 says Z will be a table, having 2 rows and 3 columns. Line 20 says the 
number in the first row and first column is 57. Line 30 says the number in 
first row and second column is 8.4. Lines 40-70 define the rest of the table. 
Line 80 prints the entire table, like this: 
oe 8.4 -6 
1000 0 ToT 
# te # 


This program prints a multiplication table: 
BOSDIN TC1O,5) 
ZOCFOR 1) = 1) FO. 10 
30 FOR] J =e15 10) 
40 T(1,J)=1*S 
50 NEXT J 
60 NEXT I 
70 MAT PRINT T 
80 END 
Line 10 says T will be a table having 10 rows and 5 columns. Line 40 says the 
number in row I and column J is I*J; for example, the number in row 3 and column 4 
is 12. Lines 20 and 30 make sure line 40 is done for every I and J, so every entry 
of the table is defined by multiplication. Line 70 prints the whole table: 


1 Z 3 4 5 
2 4 6 8 10 
6 ee 6 9 £2 its) 
4 8 i 16 20 
> 10 1D 20 22 
6 12 18 24 30 
7 14 21 28 ie 
8 16 24 Sy 40 
9 18 2/ 36 45 
10 20 30 40 50 


If you'd rather have addition, subtraction, division, or exponents, just change 
line 40. 

Most programmers follow this tradition: the rzow's number 44 called I, and the 
column's number 44 called J. Line 40 obeys that tradition. Notice I comes before 
J in the alphabet; I comes before J in T(1,J); and "FOR IL'' comes before "FOR J" in 
lines 20-30. If you follow the I-before-J tradition, you'll make fewer errors. 


* * * 


40 


This program creates two matrices by reading: 

10 DIM A(3),B(2,4) 

20 MAT READ A 
30 MAT PRINT A 
40 MAT READ B 
50 MAT PRINT B 

60FHATA -91'592,93494,95,96, 9/798 ,99 1007LOL 
70 END 
Line 10 says A will be a list of 3 numbers, and B will be a table having 2 rows 
and 4 columns. Line 20 reads A; it will be the first 3 numbers in the data. 
Line 30 prints: 

91 

og 

93 
Line 40 reads B; since B has 2 rows and 4 columns, the computer reads 8 numbers 
from, the;dataz dane: 50 prints: 


94 95 96 97 
98 99 100 101 
If you ever forget a DIM statement, the computer assumes each list has 10 
elements, and each table has 10 rows and 10 columns. If you forget to say— 


10 DIM A(3) ,B(2,4) 

the computer assumes you want— 

10 DIM A(10),B(10,10) 

so line 20 tries to read 10 elements for A, and line 40 tries to read 100, elemente 
for B. The computer will say: 

OUT OF DATA 


+ * * 


You can type these statements: 
STATEMENT MEANING 
MAT A=ZER Change matrix A, so every number in it is ZERo. 
MAT A=CON Change matrix A, so every number in it is the CONstant l. 
Here's an example: 
10 DIM A(4) 
20 MAT A=CON 
30 MAT PRINT A 
40 MAT A=ZER 
50 MAT PRINT A 
60 END 
Line 30 prints: 
1 
| 
i 
1 
Line 50 prints: 
0 


0 
0 
0 
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10 DIM A(100) 

20 MAT A=CON(3) 

30 MAT PRINT A 

40 END 

Line 10 says A will be a list of 100 numbers; but line 20 decreases the size of A 
Hoey, Lane 30, prints: 


You can change the size of a matrix several times in your program, but must 
obey two rules: 
The matrix appears in a DIM statement only once. 
The matrix never exceeds the size given in the DIM statement. 
The size can be input: 
10 DIM A(100) 


>15 INPUT N 
+20 MAT A=CON(N) 


30 MAT PRINT A 
0 END & 
If you input 3, line 40 makes the computer print: 
1 
. 
1 
Tisyousinputss. sehescomputer! prints: 
L 
1 
1 
is 
1 


If you input a number higher than 100, line 20 tries to make A larger than the DIM, 
which is not allowed, and the computer will gripe. 
You can extend the program's capabilities by changing line 10: 
10 DIM A(1000) 
Then N could be anything up to 1000. But that DIM statement makes your program 
hog 1000 spaces of the computer's memory during the entire run. While your program 
is running, any other programmer who wants to use those 1000 spaces has to wait. 
Be polite: make your DIMensions small. 
The dimensions you input can be for a table: 
+10 DIM A(5,5) 
+15 INPUT M,N 
+20 MAT A=CON(M,N) 
30 MAT PRINT A 


40 END 

Peevou input = 

2,4 

the matrix printed will have 2 rows and 4 columns: 
1 1 1 1 

1 1 1 1 

Prey ou eLopit— 

Spe 

the matrix printed will have 5 rows and 3 columns: 


1 i 1 


ar 
Hee ee 
a 
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Most programmers follow this tradition: ‘the total number of rows 44 called 
M, and the total number of columns 44 called N. 

You can change dimensions when using CON, ZER, or READ. Here are examples: 
MAT A=ZER(M,N) 
MAT READ B(M,N) 


# # # 

10 DIM X(4) 

20 MAT INPUT X 
30 MAT PRINT X 
40 END 
Line 10 says X will be a list of 4 numbers. Line 20 prints a question mark and 
waits for you to input the 4 numbers. If you input— 

1297 Ol ne 250 

line 30 will make the computer print: 

79 

81 
2 

6 


What happens if you input 3 numbers instead of the 4? A computer manufactured 
by CDC, Xerox, or Hewlett-Packard will be unsatisfied, might gripe, and will give 
you a chance to type the fourth number. But on a PDP or Dartmouth computer, 
something different happens: the computer reduces the size of X, from 4 down to 3. 

Let's make the computer accept an inputted line of numbers and print the sum: 
ON PDP AND DARTMOUTH COMPUTERS ON CDC, XEROX, AND HEWLETT-PACKARD COMPUTERS 
DIM X(40) 10 DIM x(40) 
+12 PRINT "HOW MANY NUMBERS WILL YOU TYPE"; 
+14 INPUT N 
20 PRINT "TYPE THE NUMBERS" 
+30 MAT INPUT X(N) 

40 PRINT "YOU TYPED THESE NUMBERS:"' 
50 MAT PRINT X 


PRINT ''TYPE THE NUMBERS" 
30 MAT INPUT X 

40 PRINT "YOU TYPED THESE NUMBERS:" 
50 MAT PRINT X 


60 T=0 60 T=0 

70 FOR I = 1 TO NUM +70 FOR I = 1 TON 
80 T=T+X(1) 80 T=T+X(1) 
90 NEXT I 90 NEXT I 


100 PRINT "THE SUM IS"T 100° PRINT “THE SUM LS" T 
110 PRINT "THE AVERAGE IS"T/NUM 110 PRINT ~UTHE, AVERAGE -1S'"T/N 
120 END 120 END 
Let's begin by examining the program on the left. Line 10 says X will be a 

list of 40 numbers. Lines 20-30 wait for the user to type that list. “IfjtheAisee 
LN puts—= 
25018143. oF 

the computer automatically decreases the size of X from 40 down to 5, and also 
defines NUM to be 5. Line 50 prints: 

25) 

18 

7 

3 

Vd 

Since NUM is 5, line 70 means, "FOR I = 1 TO 5"; so lines 60-90 set T equal to the 
sum X(1)+X(2)+X(3)+X(4)+X(5), which is 25+18+7+3+77, which is 130. Line 100 prints 
130. Line 110 prints the average, which is 130/5, which is 26. 


Notice how flexible that program is. If you want to find the sum and average 
of 5 numbers, type the 5 numbers. If you want to find the sum and average of 7 
numbers, type 7 numbers. If you want to find the sum and average of 40 numbers, 


type 40 numbers. 


SE —————— 
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If you can't fit all the numbers on the same line, type just the first few of 

them, followed by an ampersand, like this: 

Dae 4 h2 3.2, 104,349, 249-7 1954 ,10000,—, 23, 178.637 20,94, 7453.28 

The ampersand tells the computer you aren't done. On the next line, the computer 
gel print another question mark, so you can continue typing the list. If you 
Panee fit all theurest sor the fet on the second line, type an ampersand at the 
end of that line too, 

The program on the right is similar, except that the lines the arrows point 
to involve N instead of NUM. That's because CDC, Xerox, and Hewlett-Packard 
computers don't understand NUM. Line 14 asks you to input N. If you Lnpu tie, 
you must input exactly 5 numbers for line 30. Ampersands are not permitted. 


* * % 


Most computers allow matrices to be composed of strings, so you can say things 
like DIM X$(5) and X$§(1)="'CARROT". But here are some restrictions: 
Hewlett-Packard: String matrices are not permitted. 


CDC: String matrices are permitted, but can't be used in statements 
that begin with MAT. 


121) iat WO String /tsts are permitted, and you can use MAT; but you can't 
use string tables. 


GO SUB...RETURN 


10 PRINT ''FATHER AND I WENT DOWN TO CAMP , 

20 PRINT "ALONG WITH CAPTAIN GOODING," 

30 PRINT "AND THERE WE SAW THE MEN AND BOYS. 
40 PRINT "AS THICK AS HASTY PUDDING." 

50 GO SUB 1000 

60 PRINT "AND THERE WAS CAPTAIN WASHINGTON" 
70 PRINT "UPON A SLAPPING STALLION," 

80 PRINT '"A-GIVING ORDERS TO HIS MEN;" 

90 PRINT "I GUESS THERE WERE A MILLION." 

100 GO SUB 1000 

110 PRINT 'THE FLAMING RIBBONS IN HIS HAT sa. 
120 PRINT ''THEY LOOKED SO TARNAL FINE, AH," 
130 PRINT 'I WANTED POCKILY TO GET" 

140 PRINT "TO GIVE TO MY JEMIMAH." 

150 GO SUB 1000 

160 STOP 

1000 PRINT 

1010 PRINT "YANKEE DOODLE, KEEP IT Ube 

1020 PRINT "YANKEE DOODLE DANDY," 

1030 PRINT ''MIND THE MUSIC AND THE STEP ," 
1040 PRINT "AND WITH THE GIRLS BE HANDY."' 
1050 PRINT 

1060 RETURN 

1070 END 

Lines 10-40 are the first verse of Yankee Doodle; lines 60-90 are the second verse; 
lines 110-140 are the third. At the end of each verse, the computer is instructed 
to "GO SUB 1000", which means go to line 1000, print the chorus (lines 1000-1050), 
and then RETURN to where it left off. Lines 10-160 are called the matin routine; 
lines 1000-1060 are the subroutine. GO SUB means "go to the subroutine"; RETURN 
means "return to the other routine, where you left off."' Lines 1000 and 1050 
make the computer print a blank line at the beginning and end of the chorus. 
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Line 160 makes the computer STOP at the end of the main routine. If you omit 
the STOP, the computer will proceed to do the subroutine an extra time, and then 
won't know where to RETURN to. It will gripe, by saying: 

RETURN BEFORE GOSUB IN LINE 1060 
So as a general rule, to avoid such gripes, the last line of a main routine should 
be STOP. 


REMARK 


Once in a while, jot a note, to remind yourself what your program does and 
what the Variables “étand for. Slip the note into your program, by callingere 
a REMARK: 
10 REMARK THIS PROGRAM IS JUST ANOTHER DUMB EXAMPLE 
20 N=3 
30 N=N+1 
4Q REMARK NOW N IS 4 
50 PRINT N 
60 REMARK THE COMPUTER PRINTS JUST 4 
70 END 
When you type RUN, the computer ignores the remarks. Line 50 makes the computer 


print 4. The computer ignores any line that begins with the word REMARK or the 
letters REM. 


Special. feature, avatlable on. POP-10,"2pr-TT, and Dartmouth computers: the 
computer ignores anything after an apostrophe, so you can write the remarks like 
this: 

10' THIS PROGRAM IS JUST ANOTHER DUMB EXAMPLE 
20 N=3 

30 N=N+1' NOW N IS 4 

50 PRINT N' THE COMPUTER PRINTS JUST 4 

70 END 


TURNING A VAGUE IDEA INTO A PROGRAM 


First, decide on your ultimate goal. Be optimistic. Maybe you'd like the 
computer to play a perfect game of chess? Or translate every English sentence 
into French? 


Chances are, whatever you want the computer to do, someone else has thought 


of the same idea already, and written some kind Of program. Find out. Asketic 
people in your computer center. Check computer textbooks and journals. There are 


books that list what programs have been written. Check the library in your 
town, school, and computer center. (Most computer centers have their own libraries.) 
Write to the company that made your computer. Even if you don't find exactly the 
program you're looking for, you may find one that's close enough to be okay, or 
that will work with just a little fixing, or can serve as part of your program, oF 
will at least give you a clue as to where to begins= ii one” ol the text booke ter 
journals, you'll probably find ,a discussion of the problem you're trying to solve, 
and the pros and cons of various solutions to 1t—~some methods are faster than 
others. Remember: if you keep your head in the sand, and don't look at what other 
people have done already, your programming effort may turn out to be a mere exercise, 
of no value to the rest of the world. 

All too often, programmers embark on huge projects and never get them done. 
Once you have an idea of what's been done before, and how hard your project seems 
to be, simplify it. Instead of making the computer play a perfect game of chess, 
how about settling for a game in which the computer plays unremarkably but at least 
doesn't cheat? Instead of translating every English sentence into French, how about 
translating just English colors? (We wrote that program already.) In other words, 
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pick _a less ambitious, more realistic goal, which if you achieve it, will make you 


feel good and will be a steppingstone to your ultimate goal. Finding a bug in a 
program is like finding a needle in a haystack: it's easier to remove a needle 
from a small haystack than to wait until more hay has been piled on and then trying 
to find the same needle. 


+ * + 


Make your new, simple goal more precise. That's called specification. One 
way to be specific is to draw a picture, showing what your terminal's screen or 
paper will look like if your program's running successfully. 

In that picture, find the lines typed by the computer. They become the PRINT 
statements in your program. Find the lines typed by the human: they become the 
INPUT statements. Now you can start writing your program: write the PRINT and INPUT 
statements on paper, with a pencil, and leave blank lines between them. You'll fill 
in the blanks later, and won't type on the terminal until Yours imsipdratt ms 
complete. 

Suppose you want the computer to find the average of three numbers. Your 
picture will look like this: 


aA. 
10 PRINT "WHAT ARE THE THREE NUMBERS"; 
20 INPUT A,B,C 
etc, 
100 PRINT "THE AVERAGE IS'"'D 
etc. 
All you have left to do is figure out what the "etc." is. Here's the general 


method.... ; 
x * + 


Suppose you didn't have a computer. Then how would you get the answer? 

Would you have to use a mathematical formula? If so, put the formula into 
your program, but remember that the left side of the equation must have just one 
variable. For example, if you're trying to solve a problem about right triangles, 
you might have to use the Pythagorean formula A2+B=C2; but the left side of the 
equation must have just one variable, so your program must say A=SQR(Ct2-Bt2), or 
B=SQR(C+2-At2), or C=SQR(At2+B+2), depending on whether you're trying to compute 
ee ene Cy 

Would you have to use a memorized list, such as an English-French dictionary 
or the population of each state or the weight of each chemical element? If so, 
that list becomes your DATA, and you need to READ it. If it would be helpful to 
have to data numbered, so the first piece of data is called X(1), the next piece 
of data is called X(2), etc., use MAT READ instead of READ, and don't forget the 
DIM statement. 
| Subscripts are particularly useful if the human will input many numbers on the 
| same line (use MAT INPUT) or if one long list of information will be referred to 
several times in the program. 

Does your reasoning repeat? That means your program should have a Loop. Lf 
you know how many times to repeat, say FOR...NEXT. If you're not sure how often, 
say GO TO or IF...THEN. If the thing that's to be repeated isn't repeated 
| immediately, but only after several other things have happened, call the repeated 
: part a subroutine, put it at the end of your program (followed only by RETURN and 

END), and say GO SUB whenever you want it done. 
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At some point in your reasoning, do you have to make a dectston? Do you 
have to choose among several alternatives? The way to say "choose! is: IF...THEN. 
If you want the computer to make the choice arbitrarily, "by chance'', rather than 
because of a reason, say: IF RND<.5 THEN. 

Do you have to compare two things? The way to say "compare A with. BY iis: 
IF A=B THEN. 


% * % 


After you've written a few lines of your program, you may find that your 
reasoning "almost repeats"; several lines bear a strong resemblance to each other. 
You can't use GO TO or FOR...NEXT or GO SUB...RETURN unless the lines repeat 
exactly. To make the repetition complete, use a variable to represent the parts 
that are different. 

For example, suppose your program contains these lines: 
130 PRINT 29.3428+9.87627*SQR(5) 
140 PRINT 29.3428+9.87627*SQR(7) 
150 PRINT 29.3428+9.87627*SQR(9) Te 
160 PRINT 29.3428+9.87627%*SQR(11) 3 Ayn, 
170 PRINT 29.3428+9.87627*SQR(13) 
180 PRINT 29.3428+9.87627*SQR(15) 
190 PRINT 29.3428+9.87627*SQR(17) 
200 PRINT 29.3428+9.87627*SQR(19) 
210 PRINT 29.3428+9.87627*SQR(21) 
Each of those lines says PRINT 29.3428+9.87627*SQR(a number). The number keeps 
changing, so call it X. Lines 130-210 can be replaced by: 
130 FOR X = 57710 21 
140 PRINT 29.3428+9.87627*SQR(X) 
150 NEXT X 

Here's a harder example to fix: 
130 PRINT 29.3428+9.87627*SQR(5) 
140 PRINT 29.3428+9.87627*SQR(97.3) 
150 PRINT 29.3428+9.87627*SQR(8.62) 
160 PRINT 29.3428+9.87627*SQR(.4) 
170 PRINT 29.3428+9.87627*SQR( 200) 
180 PRINT 29.3428+9.87627*SQR(12 ) 
190 PRINT 29.3428+9.87627*SQR(591) 
200 PRINT 29.3428+9.87627*SQR(.2) 
210 PRINT 29.3428+9.87627*SQR(100076) 
Again, let's use X. Those nine lines can be combined like this: 
130 FOR I .= 1. 'TO'9 
140 READ X 
150 PRINT 29.3428+9.87627*SQR(X) 
160 NEXT IL 
170° (DATA® 5997 <33 8962)7°47,.200; 12,591" 2100076 

This one's even tougher: 
130 PRINT 29.3428+9.87627*SQR(A) 
140 PRINT 29.3428+9.87627*SQR(B) 
150 PRINT 29.3428+9.87627*SQR(C) 
160 PRINT 29.3428+9.87627*SQR(D) pv 
170 PRINT 29.3428+9.87627*SQR(E) WY 
180 PRINT 29.3428+9.87627*SQR(F) 
190 PRINT 29.3428+9.87627*SQR(G) 
200 PRINT 29.3428+9.87627*SQR(H) 
210 PRINT 29.3428+9.87627*SQR(I) 


Let's assume A, B, C, D, E, F, G, H, and I have been computed earlier in the program. 


The trick to shortening those lines is to change the names of the variables. 


a 
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Throughout the program, say X(1) instead of A, say X(2) instead of B, say X(3) 
instead of C, etc. Say DIM X(9) at the beginning of your program. Then lines 
130-210 can be written: 

P202FOR Ie= 1. TO. 9 

140 PRINT 29.3428+9 .87627*SQR(X(I)) 

PSOPNEXT 1 


% * % 


Some English teachers say that before you write a paper, you should make an 
outline. Some computer teachers give similar advice about writing programs. 


The outline" can take the form of a crude flowchart, or a program in which some 


of the lines are written in plain English instead of computerese. For example, 


one statement in your outline might be: 


130 A = the average of the X's . 

Later, when you fill in the details, that statement will be expanded into the 
following: 

130. T=0 


131 FOR I = 1 TO NUM 
132 T=T+X(1) 
133 NEXT I 
134 A=T/NUM 
+ + * 


Keep the program's over-all organization simple. That will make it easier 
for you to expand it and find bugs. Here is some folklore, handed down from 
generation to generation of programmers, that will simplify your organization.... 

Use top-down programming. That means write a one-sentence description of 
your program; then expand that sentence to several sentences; then expand each of 
those sentences to several more sentences; and so on, until you finally expand the 
sentences-that-came-from-sentences—that-came-from-sentences into lines of program. 
Your program will then be in the same order as the English sentences, and therefore 
will be organized the same way as an English-speaking mind. 

A variation is to use subroutines. That means writing the essence of the 
program as a very short main routine; instead of filling in the grubby details 
immediately, replace each piece of grubbiness by the words GO SUB. After the 
main routine 1s written, write each subroutine. Your program will be like a good 
book: your main routine will move swiftly, and the annoying details will relegated 
to the appendices at the back; the appendices are called subroutines. Keep each 
subroutine down to 50 lines; if it starts getting longer and grubbier, replace each 
piece of grubbiness by a GO SUB to another subroutine, written afterwards and having 
higher line numbers. 

Avoid GO TO. It's hard for a human to understand a program that's a morass 
of GO TO statements. It's like trying to read a book where each paragraph says to 
turn to a different page! When you must say GO TO, try to go forward instead of 
backwards, and not go too far. The same advice goes for IF...THEN. 

Divide your program into modules. A module is a bunch of consecutive lines 
forming a unit that cannot be "punctured''; in other words, there is no GO-TO-type 
statement outside the module that sends the computer to the module's middle; the 
only way the module can be activated is by starting with its top line. (If the 
module is particularly nice, the only way it can be deactivated is by arriving at 
its bottom line; in other words, there is no GO-TO-type statement in the module's 
middle that sends the computer outside the module.) If you used top-down 
programming, each module probably corresponds to one sentence in your program's 
description. Write that sentence at the top of the module, as a REMARK. 
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Use spacing. Put a blank line before every module. (To type a blank line, 
type a line number, then press the space bar, then press the carriage return.) 
Indent between the words FOR and NEXT. When you say— 
130 IF X<3 THEN 180 
indent the lines that come after 130 and before 180. If a loop ends with the words 
GO TO, indent the entire loop except for its top line and the GO TO. 

Sometimes I ignore that folklore. But often it's helpful. 


EFFICIENCY 


Your program should be efficient. That means it should use as little of the 
computer's time and memory as possible. 
To use less of the computer's memory, make your DIMensions as small as possible. 
Try writing the program without any matrices at all; if that turns out to be 
terribly inconvenient, use the smallest and fewest matrices possible. 
To use less of the computer's time, avoid having the computer do the same thing 
more than once. 
These lines force the computer to compute SQR(8.3*N+7) three times: 
20 PRINT, SQRGS .34N4F2)42 
60 PRINT SQR(8.3*N+7)/9.1 
70 PRINT 5-SQR(8.3*N+7) 
You should change them to: 
*49 K=SQR(8.3*N+7) 
290. PRINTAK+2 
60 PRINT K/9.1 
>TOSPRINE 5 —K 
These lines force the computer to compute X+9+2 a hundred times: 
SOD ROR LS =act aL a VO) 


60 PRINT (X94 2:01 

70 NEXT I 

You should change them to: 
749 K=Xt9+2 

DUMP OK ee eek LO) LOU 
>60 PRINT K/I 

FAS Tea 59 6d NOM 

These lines force the computer to count to 100 twice: 

50 T=0 

60 FOR I = 1 TO 100 

70 T=T+X(T) 

80 NEXT I 

OC PRINT “THe SUM On, Tie kes stort 
100 P=1 


PL) FOR SL = mie TOST00 

120 P=P*X(1) 

130. NEXT -I 

140 PRINT 'THE PRODUCT OF THE X'S IS"'P 
You should change them to: 


5 Uft i= () | 
+5) P=] 
60:FFOR fool tOal OG | 
70 T=T+X(L) 
Sh P=P*X(1) 
80 NEXT I 


90 PRINT: “THE SUM OF THE <7 ost 
140 PRINT ''THE PRODUCT OF THE X'S IS"'P 


+ * * 
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Suppose you want the computer to alphabetize a list of names. What's the best 
strategy? Imagine trying to alphabetize the list yourself—each name is written on 
a file card, and you have to put the deck of cards in alphabetical order. One 
strategy would be to compare the second card with the first, interchange them if 
necessary, then look at the third card, do another interchange if necessary, and 
so on to the end of the deck. A different strategy would be to put all the A's in 
one pile, all the B's in another, etc., and then sort each pile. Which strategy 
is better? If the file has ten cards: or less, the interchange method is faster; 
if the file ts very long, the 26-pile method is faster but requires space to lay 
out 26 piles. Which method would make a more efficient program? That depends on 
how long the file is and whether your computer's main lack is fast parts or large 
memory. 


% + + 


An integer is called compostte if it is the product of two other integers. 
35 is composite, because it is 5*7; 9 is composite, because it is 3%*3; 12 is 
composite, because it is 2*6; 13 is not composite, and is therefore called prime. 
This program tells whether a number is prime or composite: 
10 PRINT ''IYPE A POSITIVE INTEGER" 


20 INPUT N 

30 FOR I = 1 TO N-1 

40 FOR J = 1 TO N-1 

50 IF N=I*J THEN 100 I4 N <4 prime, Line 50 44 encountered (N-1)2 times. 
60 NEXT’ J For example, 44 N 45 a prtme near a mellion, 
7O.NEXT <I Line 50 44 encountered about 1,000,000,000,000 tkmez 
80 PRINT N"IS PRIME" 

90 STOP 

100 PRINT N"IS COMPOSITE" 

110 END 


Lines 10-20 wait for you to type a number N. Line 50 checks whether N is the 
product of two other integers; if it is, the computer jumps to line 100 and prints 
N"IS COMPOSITE". How efficient is the program? Since it contains no matrices, it 
doesn't require much space in the memory. But if N turns out to be prime, line 

50 is encountered once for every I and once for every J; altogether it is 
encountered (N-1)2 times. If N is a large number, around a million, (N-1)? is 
erouncma trillion =o do line 50ca trillion times will take a typical’ computér 
several months. The program is very inefficient. 

Some small improvements are possible; for example, I and J can start at 2 
instead of 1. But so long as we have a loop inside a loop, the time will remain 
very large. Here's a strategy that requires only one loop: try dividing N by 
every integer less than it, and see whether the quotient is ever an integer. 
Here's the program: 

TOUPRENT “TYPE AuPOSITIVE INTEGER" 


20 INPUT N 
730 FOR T=) 29 TO! N-1 
+40 Q=N/1 
+50 IF Q=INT(Q) THEN 100 I4N %s prime, Line 50 &% encountered N-2 tunes. 
70 NEXT I Fox example, 44 N 45 a prtme near a million, 
80 PRINT N"IS PRIME" kine 50 44% encountered about 1,000,000 times. 
90° STOP 
100 PRINT N"'IS COMPOSITE" 
110 END 
Line 40 divides N by an integer. Line 50 says: if that quotient is an integer, 


jampeto line 100, which prints: NS GOMPOSITE". If N turns out to be prime, line 
50 is encountered once for every I; altogether it is encountered N-2 times. That's 
less than in the previous program, where it was encountered (N-1)2 times. If N is 
about a million, our new program is about a million times faster than the previous 
one! It will take a typical computer several seconds, instead of several months. 
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Further improvements are possible. If an N can't be divided by 2, it can't 
be divided by any even number; so after checking divisibility by 2, we have to 
check divisibilitysby just. 3, 5, 7,.\..., Nr2., Let's put, thatisnort-cut anto oun 
program, and also say that every N less than 4 is prime: 

10 PRINT "TYPE A POSITIVE INTEGER" 
ZORINPUEON 

+21 IF N<4 THEN 80 

+28 Q=N/2 

+29 IF Q=INT(Q) THEN 100 

>30. FORM a2 3eTOeN=Ze SLEEP a2 


40 Q=N/I y 

50 IF Q=INT(Q) THEN 100 14 N 4&4 prime, Line 50 44 encountered g72 times. 
a eauterite Ser Fon example, 44 N 4b a prrcme near a million, 

90 STOP kine 50 44 encountered about 500,000 times. 

100 PRINT N''IS COMPOSITE" 

110 END 


Lines 28-29 check divisibility by. 23 lines. 30-/70,check divisibility by ou o.eee 
N-2. If N is prime, line 50 is encountered 572 times, which is about half as 


often as in the previous program; so our new program takes about half as long to 
run. 

Our original object was to find a pair of integers whose product is N. If 
there is such a pair of integers, the smaller one will be no more than YN, so we 
can restrict our hunt to the integers not exceeding VN: 

10 PRINT "TYPE A POSITIVE INTEGER" 
20 INPUT N 
21 IF N<4 THEN 80 
28 Q=N/2 
29 IF Q=INT(Q) THEN 100 
+30 FOR I = 3 TO SQR(N)*1.00001 STEP 2 
40 Q=N/I 


50 IF Q=INT(Q) THEN 100 If N && patme, Line 50 Ls encountered 2S - 1 times. 
a See pind Speen Fon example, 44 N 45 a prime near a million, 

90 ‘STOP kine 50 4% encountered about 500 times. 

100 PRINT N'"IS COMPOSITE" 

110 END 


The "*1.00001"" is to give a margin of safety, in case the computer rounds SQR(N) a 
bit down. If N is a prime near a million, line 50 is encountered about 500 times, 
which is much less than the 500,000 times encountered in the previous program and 
the 1,000,000,000,000 times encountered in the original. It will take the computer 
only a small fraction of a second. 

The frightening thing about this example is that the first version we had was 
so terrible, but the only way to significantly improve it was to take a totally 
fresh approach. To be a successful programmer, you always have to keep your mind 
open, and hunt for fresh ideas. 
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SILLINESS 


Skim through your program and eliminate any lines that are silly. Here are 
examples of silly lines; I assume your program is numbered 10, 20, 30, 40... 
A GO TO that goes to the next line: 
30 GO TO 40 
Omit-it. The computer will go to line 40 anyway. 
A GO TO that goes to the END: 
30 GO TO 990 where line 990 says END 
Say: 
30 STOP 
A GO TO that goes to a GO TO: 
30 GO TO 100 where line 100 says GO TO 200 
Say: 
30 GO TO 200 
An IF that goes to the next line: 
30 IF X<7 THEN 40 
When the computer encounters line 30, what happens? If X is less than 7, the 
computer jumps to line 40. But if X is mot less than 7, the computer proceeds 
from line 30 to the next line—which is line 40 anyway! So the computer always 
goes from line 30 to line 40, regardless of whether X is less than 7. There's 
Hocwiug Lify .vaboutethersituation; ’so.don' tusay IF? /Justisay: 
30 GO TO 40 
But "30 GO TO 40" is silly; so just eliminate the line altogether. Warning: 
when writing ''30 IF X<7 THEN 40", you were probably trying to say, ''do line 40 
only if X<7."" Here's how to say it: 
30 IF X>=7 THEN 50 
An IF that just skips over a GO TO: 
S07. F  X<7 “THEN 50 
40 GO TO 100 
Combine those two lines into a single line: 
30 IF X>=7 THEN 100 
The new line 30 says: if X>=7, jump to line 100; but if X<7, proceed to the next 
line, which is now line 50. 
An IF followed by its opposite: 
30° ITF X<7" THEN 100 
40 IF X>=7 THEN 200 
Remove the IF from line 40: 
B80 IF X<7 THEN 100 
+40 GO TO 200 
The new version does the same thing as the original, because the computer reaches 
the new 40 only if X is not less than 7. 
Here's another IF followed by its opposites: 
30 IF X<7 THEN 100 
40 IF X=7 THEN 200 
50 IF X>7 THEN 300 
Remove the last IF: 
30 IF X<7 THEN 100 
40 IF X=7 THEN 200 
+50 GO TO 300 
By removing one piece of silliness, you may uncover another. For example, 
here's a piece of silliness—an IF followed by its opposite: 
30 IF X<7 THEN 50 
i 40 IF X>=7 THEN 200 
) Applying our rules of cosmetics, we get: 
30 IF X<7 THEN 50 
+40 GO TO 200 
But now line 30 is an IF that just skips over a GO TO; we've uncovered another piece 
of silliness! Applying more cosmetics, we get down to a single line: 
30 IF X>=7 THEN 200 
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ROUNDOFF ERROR 


The computer cannot handle decimals accurately. If you say X=.1, the computer 
is unable to set X equal to .1 exactly; instead, it will set X equal to a number 
very, very close to .1. The reason for the slight inaccuracy is that the computer 
thinks in "binary", not decimals; and .1 cannot be expressed in binary exactly. 

Usually you won't see the slight inaccuracy; because when you ask the computer 
to PRINT a number, the computer prints it rounded to six significant figures, and 
the inaccuracy is so small it doesn't show up in the rounded result. But there are 


three situations in which the inaccuracy can be noticed: 


ibs Telling the computer to do A-B, where A is almost equal to B, and the 


first several digits of A are the same as the first several digits of B. For 
example, if you ask a PDP-10 computer to print 4.001-4, the computer will not 
print .001; instead it will print .000999987. The same thing happens if you do 
4.001+(-4). Lf.you ask the computer to’ print 12345678.9312345678.8, it) will prime 
125 instead of .1. . The error can get magnified: (ifisyou ask; the scomputer ito 
multiply 12345678.9=12345678.8 by 1000, 1t will print 212571000; whtehmiem 22 
instead of .1*1000,¢whichjis 100:  eligyow askin titosiirad ttiedreciproca lot 
1234567859=1234567 8:85 itewill print+1/91255" which ¥sese instead “of o)/ Sijawnneiene 
10. 

Those are the-errors you'll get. from a PDP-10 computer: The PDP-10 is more 
accurate than most other computers, which give errors that are even worse. On CDC 
computers, the errors are slightly less. 


2. (Saying)!'FOR:X =. A TO B STEP GC", where G vs 4 decimal and the loop will be 


done many times. For example: 
LOMFORRXE = 7/0 TOL OS eS TERPS a 


20 PRINT X 
30 NEXT X 
40 END 


Theoretically, the last few numbers the computer prints should be: 
19:2)..6 
1O2F 
12. 
Lo 
193 
But that's not what actually happens. In line 10, the computer can't handle the 
decimal .1 accurately. The last few numbers a PDP-10 computer thinks of are: 
slightly more than 192.6 
slightly more than 192.7 
slightly more than 192.8 
slightly more than 192.9 
The computer does not think of the next number, slightly more than 193, because 
line 10 says not to go past 193. In line 20, the word PRINT makes the computer 
print the numbers rounded to six significant digits, so it prints: 
19276 


Oo CO ~ 


19 Zag 
1928 
192)..9 
It does not print 193. 
If you want to, compute 7 + 7.1 + 7.2°% 7.53 + 22. + 1935 you might Demtemptce 
to write this program: 
+5 T=0 
LO FOR X=" /741On E95) Ss EPee tL 
20 T=T+X 
30 NEXT X 
SJo PRUNE eT 
40 END 


The computer will print a reasonable-looking answer: 185907. But that "answer"' 
1s wrong, because the last number it added was slightly more than 192.9; it never 
added 193. The correct answer is 186100. 
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One remedy is to change line 10 to this: 
UwrORen = 7/7" TO W93s05 STEP. 1 
The .05 at the end of 193 allows for the margin of error. The general strategy is 
to change— 
FOCEORNX’= (A TO BS TEPC 
to this: 
10 FOR X = A TO B+C/2 STEP C 
An alternative remedy is to replace— 
LO FOR X= 7. TO 193 STEPV SI 
bystnis pair of lines: 
WOAPOR 1° = 70° TO 1930 
bh X=1/10 
hee Lee oes trom 9/0 to, 1930. *X will go’ from / to 193 in-steps. of-<-L.- This~remedy.is 
the most accurate of all, since it eliminates decimals from line 10. -But don't 
Eorpet to change NEXT x 'to “NEXT L": and the division in line 1] makes the program 
very slow. 

3. Asking the computer whether two numbers X and Y are equal. It's unwise to 
ask whether X is exactly equal to Y, since both X and Y have probably been affected 
by some slight error. Instead, ask the computer whether the difference between X 
and Y is much tinier than Y: 


BAD GOOD 
IF X=Y THEN 100 IF ABS(X-Y)<=.000001*ABS(Y) THEN 70 


The .000001 is requesting, roughly, that the first six significant digits of X be 
the same as the first six significant digits of Y. 


+ * * 


It may seem from the foregoing discussion that computers ought to be made 
differently, using the decimal system instead of binary. There are two 
counterarguments. First, binary arithmetic is faster. Second, even if computers 
were using the decimal system, inaccuracy would still occur. To store the fraction F 
accurately by using the decimal system, the computer would have to store a decimal 
point followed by infinitely many 6's. That would require an infinite amount of 
Space in memory, which is impossible (unless you know how to build an infinitely 
large computer?) So even in the decimal system, some fractions must be approximated 
instead of handled exactly. 
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According to mathematicians, addition is supposed to obey these laws: 
A+0 is exaetly the same as A 
A+B is exactly the same as Bt+A 
A+-A is exactly the same as 0 
(A+B)+C is exactly the same as A+(B+tC) 
On the computer, the first three laws hold, but the last does not. If A is 
a decimal tinier than C, the computer does (A+B)+C more accurately than A+(B+C). 


So to_add a list of numbers accurately, begin by adding together the tiniest 


deGimals in‘the list. 


TESTING 


When you've written a program, test it: type RUN and see whether it works. 

If the computer gripes, you know the program doesn't work, and you can start 
hunting for the bug. 

If the computer does not gripe, your tendency will be to say "Whoopee!" Don't 
cheer too loudly. The answers the computer is printing may be wrong. Even if its 
answers look reasonable, don't assume they're right: the computer's errors can be 
very subtle. Check its answers, by doing some calculations on a piece of paper. 
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Even if the answers the computer prints are correct, don't cheer. Maybe you 
were just lucky. Type different input, and see whether your program still works. 
Chances are, there's something you can input that will make your program go crazy 
or print a wrong answer. Your mission: to find input that will reveal the existence 
ofi'a bur. wilt Y Six Kinds ole input 1s. 

1. Simple input. Type“an simple integers, like 2 and 10, so the computation 
is simple, and you can check the computer's answers easily. 

2, Increasing input. -/See howsthe computer's answer changes when the input 
changes from 2 to 2.01. See how the computer's answer changes when the input changes 
from 2 to 1000. Does the change in the computer's answer look reasonable? Does 
the computer's answer go up when it should go up, and down when it should go down? 
and, by a reasonable amount? 

3.. Input .that tests each IF. , Fora program, that says—— 

30 IF X<7 THEN 100 
input an X less than 7 (to see whether line 100 works), input an X greater than 7 
(to see whether line 40 works), input an X equal to 7 (to see whether you really 
want ''<" instead of ''<="), and input an X very.close to /, to. check, roundoftif cream 
For a program that says— 
30 IF At2+B<C THEN 100 
input an A, B, and C that make At2+B less than C; that make At2+B greater than C; 
that make At2+B equal to C; and that make A*t2+B close to C. 

4. Extreme input. What happens if you input: 
huge number, like 45392000000 or 1E35? 
tiny number, like .00000003954 or 1E-35? 
trivialenumber like © or £7 
typical number, like 45.132 
negative number, like -52? 
Find out. If the input is supposed to be a string, what happens if you input AAAAA 
or ZZZZZ? If there are supposed to be two inputs, what happens if you input the 
same thing for each? 

5. Input that will make some lines in your program act strangely. If your 
program contains division, create input that will make the divisor be zero or a 
tiny decimal close to zero. If your program contains,a square root, Of a quantity. 
create input that will make the quantity be negative. If your program says 
FOR [ = A’TO B,. create input that will make B be less than A, or sedua | ato 
your program mentions X(1I), create input that will make I be zero or negative or 
greater than the DIM. Create input that causes roundoff error: for a program that 
says A-B or says IF A=B THEN 100, create input that will make A almost equal to B. 

6. Garbage. Many people hate computers because they often print wrong answers. 
A computer can print a wrong answer because its machinery is broken, or because a 


program has a bug. But the main reason why computers print wrong answers is_that 


the input is incorrect. Incorrect input is called garbage. It has several causesmeue 
The user's finger slips. .» Instead of 400), he inputs. 40004 Instead -ofm7/ amie 


inputs,/2. Trying to type../523,. he, leaves woul the decimalypoint. 

The user got wrong information. He tries to input the temperature, but his 
thermometer is leaking. He tries to input the results of a questionnaire, but 
everybody who filled out his questionnaire lied. 

The instructions aren't clear. The program asks HOW FAR DID THE BALL FALL, and 
the user doesn't know whether to type the distance in feet or in meters. Is time 
to be given in seconds or minutes? Are angles to be measured in degrees or radians? 
If the program asks WHAT IS YOUR NAME, should the user type JOE SMITH or "SMITH, JOE" 
or just JOE? Can the user input Y instead of YES? Maybe the user isn't clear 
about whether to insert commas, quotation marks, and periods. If several items are 
to be typed, should they be typed on the same line or on separate lines? If your 
program asks HOW MANY BROTHERS AND SISTERS DO YOU HAVE, and the user has 2 brother 
and 3 sisters, should he type 5. or: "253" or "“2.BROTHERS AND 3 SISTERS’? stoeue 
quiz that asks WHO WAS THE FIRST PRESIDENT OF THE UNITED STATES, what if the user 
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answers GEORGE WASHINGTON or simply WASHINGTON or G. WASHINGTON or GENERAL GEORGE 
WASHINGTON or PRESIDENT WASHINGTON or MARTHA'S HUSBAND? Make the instructions 
clearer: 

WHO WAS THE FIRST PRESIDENT OF THE UNITED STATES? 

GIVE JUST HIS LAST NAME. 


The user is trying to be funny or sabotage the computer. Instead of inputting 


his name, he types an obscene comment. When asked how many brothers and sisters 
he has, he says 275. 


It's your responsibility as_a programmer to make sure that the directions for 
using your program are clear, and that the program rejects ridiculous input. For 


example, if your program is supposed to print weekly paychecks, it should refuse 
to print checks for more than $10000. Your program should contain these lines: 
20, INPUT X 

30 IF X>10000 THEN 100 


FOOCPRING XxX" IS /QUITELA BIG, PAYCHECK! I DON'T BELIEVE YOU." 
110 PRINT "PLEASE RETYPE YOUR REQUEST." 
P207G0, 10/20 
Lines 30 and 100-120 are called an error-handling routine. Your program should 
contain several, to prevent printing checks that are too small (2¢?) or negative 
or otherwise ridiculous ($200.73145?) 

To see how your program reacts to input that's either garbage or unusual, 


ask the person sitting next to you to run your program. He might input something 


you never thought of. 


DOCUMENTATION 


Write an explanation that helps other people understand your program. An 
explanation is called documentation; when you write an explanation, you are 
documenting the program. The documentation can be written on a separate sheet of 
paper (to be put in the computer center's library), or printed when the user types 
RUN or LIST. A popular device is to begin the RUN by making the computer ask the 
user.. 

DO YOU NEED INSTRUCTIONS? 
Two kinds of documentation are needed: how to use the program, and the method by 
which the program was written. 

Your explanation of how to use the program should include.... 


the program's name, and how to get the program from the disk 
the program's purpose 


a list of other programs that must be combined with this program, to make a 
workable combination 


the correct way to type the input and data (show an example) 
the correct way to interpret the output 


the program's limitations (input it can't handle; a list of error messages that 
might be printed; roundoff error) 


a list of bugs you haven't fixed yet 
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An explanation of how the program was written will help other programmers 
borrow your ideas, and expand your program to meet new situations. It should 
inciude.%.% 


your name 

the date you finished it 

the computer you wrote it for 

the language you wrote it in (probably BASIC) 


the name of the method used (example: this program solves quadratic equations by 
using the quadratic formula, solves triangles by using the law of sines, solves 
simultaneous linear equations by using Gauss-Jordan elimination, and alphabetizes 
the data by using a bubble sort) 


the name of the book or journal where you found the method 
the name of any program you borrowed ideas from 


an informal explanation of how the program works ("It keeps looping until At2 is 
greater than 2*B, which makes it jump to subroutine 1000 and compute the weather 
forcast for’ Tuesday.'') 


the purpose of each module 
the meaning of each variable 


the meaning of arriving at a line (for a program saying IF X<60 THEN 1000, you 
might make this comment: "Arrival at line 1000 indicates the student flunked.") 
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The Amertcan Nattonal Standards Institute (ANSI) and the Internattonal 


Organtzation for Standardizatton (ISO) urge you to use these flowchart symbols.... 


For beginnings and endings, use an oval: 


beginning of a program 
ending of a program 


beginning of a subroutine nicknamed CHORUS CHORUS 


ending of a subroutine (RETURN 


For input and output, use a slanted parallelogram: 


INPUT X OUT OF DATA 


READ Z CEND ) 
For a decision, use-a diamond: 


PRINT V HELLO! 


ae 


Here's how to indicate FOR: 


| (FOR N = 1 TO 7) 


For other operations, use a rectangle: 


aoa 


Here's how to attach a remark: 
= f N is negative, 
X=SQR(N) the computer will gripe. 


You can split a large flowchart, to form smaller ones: 


END 
When an operation is performed by a subroutine, use stripes. Ir the details 
of the subroutine are not included in the flowchart, the stripes are vertical: 


You can write the line number on the left corner of each outline: 


10 


20 


If a flowline points in the same direction as you read English (from left to 
right, from top to bottom), you can omit the arrowhead: 
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EDITING 


On most computers, you can give commands that will do the following: 
list just part of your program 
delete a large chunk of your program 
measure how long your program is 
change the line numbers, so they go 10, 20, 30, etc. 
combine two programs, to form a bigger one 
Unfortunately, each computer manufacturer has a different way of doing that. 
The details are in the Commentary. 


OTHER HARDWARE 


Computer machinery is called hardware; computer programs are called software. 
The main pieces of hardware we've discussed are the terminal, the disk, core 
memory, and the part of the computer that "thinks'', which is called the 
Central Processing Unit (abbreviated CPU). Additional pieces of hardware can be 
attached to the computer. You can attach a plotter, which is a moving pen that 
draws pictures. You can attach a lineprinter, which prints very quickly (18 lines 
per second is typical). Instead of storing programs on disks, you can store them 
on magnetic tape, or paper tape, or cards. Instead of printing answers on the 
terminal's screen or paper, you can print them on a disk; then you can make 
another program that reads them from the disk, instead of reading from a DATA 
statement. 

Curious? Read the Commentary . 
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